GuiCommand model Wiki page
Forum rules
Be nice to others! Respect the FreeCAD code of conduct!
Be nice to others! Respect the FreeCAD code of conduct!
GuiCommand model Wiki page
Perhaps this thread can serve for discussion and change requests to the GuiCommand model page?
Notes
The GuiCommand model page does not show how to format Notes. Especially, should they go into a separate section or a the end of the Usage section? (If someone could add this directly to the page, that would be perfect, I think.)
Re: GuiCommand model Wiki page
here, you have some details how to write pages for the wiki
WikiPages
https://wiki.freecadweb.org/Help:Editing
humm, looking for details about how to format Notes, i don't find. may be a miss.
WikiPages
https://wiki.freecadweb.org/Help:Editing
humm, looking for details about how to format Notes, i don't find. may be a miss.
Re: GuiCommand model Wiki page
I have changes the GuiCommand_model page a little bit:
- Reordered the paragraphs. Changed 'Limitations' to 'Notes'.
- Reworded the 'Usage' paragraph.
- Removed {{Emphasis}} from 'See also'.
- Added {{TitleProperty}} in the 'Properties' paragraph.
Re: GuiCommand model Wiki page
The following is not yet covered, I think. I propose to add after "Insert here a short description of what the command does." something like:
Code: Select all
The description can refer to workbenches such as the [[Image:Workbench_Sketcher.svg|24px]] [[Sketcher_Workbench|Sketcher Workbench]]. (''Editor note:'' The image is 24px, not 16px)
Re: GuiCommand model Wiki page
hmk, do you plan to cover the Docnav and the Guicommand?
in Guicommand, the SeeAlso section only receives links to other tools. Tutorials, special pages are, from what i have seen, put in a chapter "related".
a detail but it helps translators, [[workbench_tool|workbench tool]] or [[the_link_to_the_page|the link to the page]]. when we use automatic translators on line, the the_link_to_the_page is not translated while "the link to the page" can be.
in Guicommand, the SeeAlso section only receives links to other tools. Tutorials, special pages are, from what i have seen, put in a chapter "related".
a detail but it helps translators, [[workbench_tool|workbench tool]] or [[the_link_to_the_page|the link to the page]]. when we use automatic translators on line, the the_link_to_the_page is not translated while "the link to the page" can be.
Re: GuiCommand model Wiki page
I am not familiar with the Docnav, I don't plan to touch it.
The "See also" of GuiCommand is empty: So there is no consensus what goes in here, right? I am happy to follow any rule. The important thing for me is to have a rule.in Guicommand, the SeeAlso section only receives links to other tools. Tutorials, special pages are, from what i have seen, put in a chapter "related".
Thanks, that is good to know! I have already started to format like this, but now I understand why.a detail but it helps translators, [[workbench_tool|workbench tool]] or [[the_link_to_the_page|the link to the page]]. when we use automatic translators on line, the the_link_to_the_page is not translated while "the link to the page" can be.
Re: GuiCommand model Wiki page
There is this comment on the page:
<!--add links to similar commands; delete this row if not used-->
But I do not know how strict this is.
Thanks for your suggestions. I'll try to implement them.
Re: GuiCommand model Wiki page
I've thought i've read this information but i am not capable to proove it with a page. may be an issue with my memory.
when i've reworked the docnav and guicommand, very seldomely i've seen links to other thing than page of tools.
about the docnav, it is already well defined here https://wiki.freecadweb.org/WikiPages#Setting_Docnav
by the way, i am not a fan of folded chapter because if we click on the chapter from the index table of the page, we don't jump to the corresponding chapter. i know it avoids to have huge pages.
when i've reworked the docnav and guicommand, very seldomely i've seen links to other thing than page of tools.
about the docnav, it is already well defined here https://wiki.freecadweb.org/WikiPages#Setting_Docnav
by the way, i am not a fan of folded chapter because if we click on the chapter from the index table of the page, we don't jump to the corresponding chapter. i know it avoids to have huge pages.
Re: GuiCommand model Wiki page
+1.
What I like even less, if I search such a page, the search misses collapsed text! This is a particularly annoying example: Expressions