On Wed, Oct 29, 2008 at 6:48 AM, alinome.net <[EMAIL PROTECTED]> wrote: > > While updating the docs I find not only the content is scattered, but > some concepts are described with different terms in some pages. > > E.g.: In docs.index.variables I adopted a convention, inspired by the > current docs: sytem variable, page variable, text variable... But I > just found docs.tutorials.data about "data management", with terms > like "data field". In fact it's about "page variables". I made little > changes to mention the term "page variables" and link to > docs.index.variables, to make life easier for beginners, but changing > the terminology would need much rewriting.
This is good... The only "correction" I would make, is that with the addition of the "info" command/function to core, I have tried to refer to text variables as info variables. That will help people learn the value of the corresponding values and clearly distinguish them from data variables. It was kind of a big decision made quietly, but in the long run I think it will help if we get used to the new nomenclature and update the docs. Page variables are variables specifically connected with the page name, like p1, p0, and page. So these would be distinguished from data variables, though obviously data variables are specific to a page. But page variables are not editable, data values are. With this in mind, "data management" and "data fields" (the label of some data value) and "data values" are all appropriate terminology. As would an info field/value. > I know the cause of this is BoltWire's features and terms have quickly > evolved, while many docs are stagnant. I suggest we should think about > a conventional terminology and adopt it. It would be very helpful for > editing the docs and keeping them updated, and also for learning > BoltWire. Agreed. Thanks for your help with the docs and everyone's patience with our imperfect documentation. We'll get there eventually. Others who might want to help should just let me know the BoltWire user name and I'll add them to the editor's list. Cheers, Dan --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "BoltWire" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/boltwire?hl=en -~----------~----~----~----~------~----~------~--~---
