MoodleDocs version grouping

MoodleDocs version grouping

av Arjan de Wit -
Antall svar: 10

My name is Arjan de Wit and I'm working as an IT documentation employee at a Dutch software company. We use the Moodle system for our e-learning purposes, but I have a question about the Moodle docs website, which is not related to the Moodle system itself. I'm not sure if someone can help me with this or if this is the right place to ask, but hopefully you can point me in the right direction.

At our company we are using a Mediawiki website for documenting our software. Right now, I am trying to find a solution to restructure the Wiki in a similar way to the Moodle docs pages. Our customers can have different versions of our software and I am wondering how we could structure the Wiki in a way that pages can be related to a certain software version. Thus giving customers the possibility to choose a certain version and thereby showing only relevant pages to that version.

I have searched every possible Mediawiki related page, but it seems Moodle Docs is the only place that has it structured like this. Is there some mediawiki extension used at docs.moodle.org? Or did the developers program this structure themselves? And how does this work in practice? How do you add articles to a certain version of Moodle? I suppose some kind of Categories?

Any suggestion or idea is welcome!

Gjennomsnittlig vurdering: -
Som svar til Arjan de Wit

Re: MoodleDocs version grouping

av Mary Cooch -
Bilde av Documentation writers Bilde av Moodle HQ Bilde av Particularly helpful Moodlers Bilde av Testers Bilde av Translators

Each time we have a new version the previous wiki is cloned to make the new one -does this page in the developer documentation help? http://docs.moodle.org/dev/New_docs_version_process

Gjennomsnittlig vurdering:Useful (1)
Som svar til Mary Cooch

Re: MoodleDocs version grouping

av Arjan de Wit -

Wow, that is really helpful! Now you've shown the way, it is actually pretty straight forward, cloning the database and changing all relevant pages... did not thought of it myself blunker.. time to make some changes at our wiki.

Thanks so much for your quick reply!

Arjan

Som svar til Arjan de Wit

Re: MoodleDocs version grouping

av Séverin TERRIER -
Bilde av Documentation writers Bilde av Particularly helpful Moodlers Bilde av Testers Bilde av Translators

The counterpart being that if/when something needs to be ammended/corrected, you have to (manually) do it in several wikis.

Take time to think about that...

Gjennomsnittlig vurdering:Useful (1)
Som svar til Séverin TERRIER

Re: MoodleDocs version grouping

av Mary Cooch -
Bilde av Documentation writers Bilde av Moodle HQ Bilde av Particularly helpful Moodlers Bilde av Testers Bilde av Translators

Yes Séverin - although in the English speaking documentation we only amend the current and the previous versions (so 2.7 and 2.6 at the moment)

Gjennomsnittlig vurdering:Useful (1)
Som svar til Mary Cooch

Re: MoodleDocs version grouping

av Visvanath Ratnaweera -
Bilde av Particularly helpful Moodlers Bilde av Translators
Mary

You said:
> we only amend the current and the previous versions (so 2.7 and 2.6 at the moment)

That is news to me. I though you would back port ammendments to any previous wiki. (From memory, can't find the forum post.)

@Arjan
You might want to look at this discussion https://moodle.org/mod/forum/discuss.php?d=193518, and many similar ones, before making the decision.
Som svar til Visvanath Ratnaweera

Re: MoodleDocs version grouping

av Mary Cooch -
Bilde av Documentation writers Bilde av Moodle HQ Bilde av Particularly helpful Moodlers Bilde av Testers Bilde av Translators

Visvanath - if I recall correctly I said to you personally I'd paste in any  edits of yours that you wanted to go into earlier versions, but as a  rule we only add to the current and previous  documentation.

Som svar til Mary Cooch

Dette foruminnlegget har blitt fjernet

Innholdet i dette foruminnlegget har blitt fjernet og er ikke lengre tilgjengelig.
Som svar til Slettet bruker

Re: MoodleDocs version grouping

av Mary Cooch -
Bilde av Documentation writers Bilde av Moodle HQ Bilde av Particularly helpful Moodlers Bilde av Testers Bilde av Translators

Hello both. We only actively maintain the docs for the current version and previous version -so at the moment that is 2.8 and 2.7, although of course people are welcome to add to earlier versions. With respect to Robert's comment, if you access any page of an earlier version - so for example if you go to https://docs.moodle.org/22/en/Calculated_question_type you can see there is a  note advising you to go to the most up to date version. Hopefully this might help?