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

From OpenFOAMWiki
Fragment of a discussion from Talk:Main FAQ

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)19:53, 14 September 2013

I've added a page FAQ and FAQLong which are basically queries. The page FAQ/General is the first section of the old Main_FAQ copied over. The way stuff looks needs some work:

  • in FAQ I'll change the format of the query so that instead of the tables it will have a list of sections
  • in FAQLong the main section title should be constructed from the properties (I'll have a look on how to do that)
Bgschaid (talk)09:38, 16 September 2013

I've finished the mission of copy-paste-adjusting all of the other sections for the new FAQ. I'll try to take take to start adding new stuff regarding ParaView next weekend.

In the mean time, the section breaks are looking a bit strange in the FAQLong page, because the description seems to be floating between the section header and its content. Which leads me to this question: should each section and sub-section have a space before the header starts?

It's just that I personally prefer a nice space prepended to each header title, since it makes it a bit easier to see what I'm looking for.


By the way, while editing this reply, there was this strange code below the line with the buttons "Save page" et al:

//<![CDATA[ var GME_SMALL_ICON; var editors_options

and it continues for a while... until:

 addLoadEvent(insertGoogleMapLinks); //]]> 
Wyldckat (talk)21:06, 21 September 2013

Thanks for your work:

Concerning the problem with the FAQLong: had a look at http://semantic-mediawiki.org/wiki/Help:Embedded_format but there seems to be no parameter to add stuff before or after the pages and I'm afraid http://semantic-mediawiki.org/wiki/Help:Template_format doesn't allow me to include whole pages

The strange out: I noticed it too. It seems like the extension for threaded discussions and the new editor clash. I'll have a look

Bgschaid (talk)22:20, 22 September 2013
 

I decided to switch the new FAQ online despite the minor formatting problems. THe old FAQ is now Read-only and will be removed eventually

Bgschaid (talk)09:51, 9 October 2013

Nice!

One quick question: remember the OF version image kit I had prepared and abandoned at Help_talk:Editing? Should/can I move it to the FAQ/Wiki section?

Wyldckat (talk)20:04, 11 October 2013

No: I don't remember it Yes: that's a good idea

Bgschaid (talk)20:13, 11 October 2013