| Re: New developer version V1.1.1 released [message #208 is a reply to message #207] |
Thu, 30 October 2008 09:45   |
Susanne Wunsch railML
Messages: 0
Registered: January 2020
|
|
|
|
Thanks Volker for starting documentation issues!
Dr. Volker Knollmann wrote:
> Dear friends of RailML,
>
> To give you an impression how a wiki-based RailML-documentation can look
> like, I linked and created four more documentation pages. You can find a
> list of all available pages here:
>
> http://wiki.railml.org/index.php?title=IS_Docu_Main
>
> Please provide some feedback on these pages because they will be the
> master for all subsequent documentation. Thanks!
For newbies, some "Examples" section per entry could be offered.
Changing "Elements and attributes that use xxx" to
"Elements, types and attributes that use xxx" because "tGeoCoord" is
used by type "tPlacesElement".
I don't want to discuss about translations, term "Boundary Conditions"
means "Constraints", doesn't it?
Why didn't you integrate "Notes" in the default template?
In which cases do you use <tt>...</tt>?
I mentioned, you put all railML-Elements in "<"...">". That's fine,
maybe additional <tt>...</tt> helps for recognizing the railML keyword?
Additional, they could be linked for further work on elements.
Maybe applying <tt>...</tt> to railML and XML types would do the same job.
Do we need such a template for elements, too? Why doesn't use it for
all, elements, types, attributes and attribute groups?
That's a nice template, if all keywords are described this way, we did a
great jump in acceptance of railML, I think!
Everybody can help, getting an Wiki-account and describing used keywords!
Best regards ...
Susanne
--
Susanne Wunsch
Schema Coordinator: railML.common
|
|
|
|
Members
Search
Help
Login
Home
