Extension talk:Semantic Forms/Manual

One manual page per main article section seems right to me

faceface, Thanks for pinging me in #semanticmediawiki IRC channel. I will be walking a Wikia staff member through my limited knowledge of SMW and SF at 7pm PST/12pmAEST/2amUTC tomorrow. So if you wish to eavesdrop we'll be using #semanticmediawiki for that.

I can appreciate why Yaron seems keen to keep the main article brief and to the point with only the bare minimum embellishment or repetition. Therefore I think this manual will be the most successful if there is a one-to-one relationship between a section of the main article and a page of this manual.

In one page the writer can afford to repeat for emphasis or rephrase to cater to a different type of audience. Tables can be created, illustrations may even be uploaded, and examples almost certainly should be given.

I think we should keep referring to the example of the catalog of books in a library and milk that scenarios for all that it is worth. Dreaming up different realistic ways to apply each point mentioned within the main article to illustrate how that feature might reasonably be applied to that library of books scenario.

The sections I'd be happy to tackle first would be:

1. Description
   • I've already paraphrased Yaron's description section once before so recycling that with perhaps less inhibition felt about expanding it will be short order for me. (1. tell your aidience whta you plan to tell them, 2. tell them, 3. Point out what you just told them.)
2. Form markup code
   • I'd massage that into a table form because that happens to be the way my brain best absorbs and expresses information.

--Najevi 09:34, 19 August 2009 (UTC)