How about starting to split-off the FAQ into sub-pages?

Revision as of 14 September 2013 at 19:53.
The highlighted comment was created in this revision.

Greetings!

I'm thinking about starting to split-off the FAQ into sub-pages, because this one is getting pretty big already.

My idea is to start with ParaView, since I've been answering a lot of questions on this topic on the CFD-Online forums and I think that soon I'll start to forget answers I've already given and repeated questions are starting to occur.

So, the idea was to:

Create the sub-page Main FAQ/ParaView and paraFoam.
Transfer the FAQ for it from the Main FAQ, while preserving the respective headers with links to the new location, since there are several outside linkks pointing to existing section headers/anchors.
Then to continue adding new answers for frequent questions regarding ParaView.

For reference, the sources of new information for this will be:

Best regards, Bruno

Wyldckat (talk)‎

Hi!

Good idea. Could I propose something. The conventions on this page this page need some reworking anyway. They were written before I know about the concept of sub-pages and never reworked since. The reworking is on me. But what I'd suggest is the following. Let's start a new page FAQ and make subpages FAQ/Paraview etc to that. Copy over the stuff from the old page and leave the old page intact (that way the links will still work). On the page add a reference to the new FAQ-structure and a remark that this information is outdated and they should go there. Move the new structure into the sidebar and make the old page read-only

The only "problem" would be to have a consistent table of contents for the FAQ. I'll have to think about that

Bernhard

PS: It just occurred to me that using the Semantic-Wiki functionality it would be possible to have "long FAQ" with all questions on one page (I love those) in parallel to the small pages. Just every FAQ-subpage has to be marked with a property (for instance faqChapterNumber). The faqLong will be nothing else than an "include all pages with property faqChapterNumber ordered by faqChapterNumber (but it won't work to replace Main_FAQ with this. The links mentioned above will probably be broken anyway)

Bgschaid (talk)‎

Hi Bernhard,

OK, I'm in! If you can pre-up a quick example with the Semantic-thingamabob for the new FAQ + FAQ/ParaView, I'll populate it with some heavy-duty copy-pasting mission :)

Best regards, Bruno

Wyldckat (talk)‎