Are there any standard rules for the openSUSE wiki? Things that will make it clear thoughout the wiki what things mean. What I am talking about is when to use italic, when to use bold and so on. What I do now is if it is a filename or directory or relates anyhow to what you type, I use italic when used in a sentence. When it is an actual command and I use it in a sentence, I use bold. I see others sometimes use <tt> for commands used in a line. Things you actually type, I do like: # command Also should we link as much possible things as possible, or not? What about things that meantion SUSE in any form? Should we as a standard link that to the apropriate place, or not? The same for external programs and/or companies, like Adobe, Sun, Java, Macromedia. Are there any other standards that we should be watching out for? I think that if there is consitency in all these things, it would be an advatage for the for the site. houghi -- Quote correct (NL) http://www.briachons.org/art/quote/ Zitiere richtig (DE) http://www.afaik.de/usenet/faq/zitieren Quote correctly (EN) http://www.netmeister.org/news/learn2quote.html
On 04/10/05, houghi <houghi@houghi.org> wrote:
Are there any standard rules for the openSUSE wiki? Things that will make it clear thoughout the wiki what things mean.
Why don't you update http://www.opensuse.org/OpenSUSE_Style_Guide with what you think is missing, and make it a true Style Guide.
What I am talking about is when to use italic, when to use bold and so on. .....[lots of valid question I don't know the answer to snipped].... I think that if there is consitency in all these things, it would be an advatage for the for the site.
Another thing we could do, is to pick an article, and all collaborate in making it perfect, with the right styles, formatting, headers, screenshots, command samples etc, and reach a consensus, on what it should look like. This is something we should try to do anyway probably once a month, pick an article and all collaborate to make it better. Pflodo
On Tue, Oct 04, 2005 at 12:42:45PM +1000, Peter Flodin wrote:
On 04/10/05, houghi <houghi@houghi.org> wrote:
Are there any standard rules for the openSUSE wiki? Things that will make it clear thoughout the wiki what things mean.
Why don't you update http://www.opensuse.org/OpenSUSE_Style_Guide with what you think is missing, and make it a true Style Guide.
Because I first want to be sure if there are already some standards out there or not. I will start somewhere today with things that I think are missing.
What I am talking about is when to use italic, when to use bold and so on. .....[lots of valid question I don't know the answer to snipped].... I think that if there is consitency in all these things, it would be an advatage for the for the site.
Another thing we could do, is to pick an article, and all collaborate in making it perfect, with the right styles, formatting, headers, screenshots, command samples etc, and reach a consensus, on what it should look like.
Great idea. Why not start with http://www.opensuse.org/OpenSUSE_Style_Guide I still think instead of just me starting the changes, we should discuss it on this list. e.g. I change the ` Mark up your text` where it says Fixed Font to Italic. My reasoning would be that ''text'' is easier to use then <tt>text</tt> I also do not want the wiki page a place of styling wars, I rather do that here. :-) What I mean is to first reach a decision (wich most likely not everybody will agree on) and then later put it on the page.
This is something we should try to do anyway probably once a month, pick an article and all collaborate to make it better.
I would say first get the Style Guide finished and then see how much work needs to be done on other articles. One article per month is not very much, if you just look at layout. That is only 6 pages per SUSE realease. What also needs to be done is to put articles in the correct group. What the focus could be on is really needed articles, like the FTP Server and Mail Server howto. houghi -- Quote correct (NL) http://www.briachons.org/art/quote/ Zitiere richtig (DE) http://www.afaik.de/usenet/faq/zitieren Quote correctly (EN) http://www.netmeister.org/news/learn2quote.html
participants (2)
-
houghi -
Peter Flodin