Difference between revisions of "User talk:Vater"

From PC-BSD Wiki
Jump to: navigation, search
(Blank Lines: no problem)
(reminder for myself: new section)
Line 119: Line 119:
--[[User:Tigersharke|Tigersharke]] 22:38, 29 July 2012 (PDT)
--[[User:Tigersharke|Tigersharke]] 22:38, 29 July 2012 (PDT)
== reminder for myself ==
* nbsp

Revision as of 21:48, 18 December 2012


I added some content to the 'text' section of the guidelines page that you asked about. It is still rather sparse. I suppose that part of the reason for this is that much of the site edits have been handled by Dru and myself. She mostly adding the content and usually images, and basically being the editor of the resulting handbook. I have tried to make improvements in other areas and have done some edits and image uploads (which I also tried to document some best methods).

If you have further thoughts on any part of this process, including wiki templates, wiki documentation, and anything else, I am willing to listen. I feel that what we should strive for, is a level nearing wikipedia. There are still many things that can be improved, especially things that would make an editor's job easier, shorter, or more intuitive. You found the style guidelines page, which means either it made sense to seek it, or it is something normally found on a wiki site. I am not sure of all such pages, that is part of the reason why a lot of the editor documentation is missing.

I might suggest to explore the entire wiki site and see what is here already. The special pages are very helpful for discovering problems, such as double redirects and other faulty things. I have tried to have all handbook pages categorized, and all useful pages with one of the two headers.

--Tigersharke 02:48, 6 July 2012 (PDT)

You're doing fine. I looked at your change to 'security' and don't see any problems with the wording. Its good to have another active editor on the wiki. If you have any questions about the templates or suggestions for new templates, I'm willing to assist with them. Templates can be quite challenging to create, but I eventually succeed with my ideas.

As I said once before, I want editing the wiki to be as simplified as possible while also being as automated as possible, both are accomplished by well-designed templates. It will take time to finesse those solutions in template form, but eventually they will exist.

It also helps you and any other editor, to have written guidelines and other editor documentation. With these, we can remain consistent on the entire wiki site, not only the handbook portion of it.

I think I should set aside a space somewhere for the ideas I desire or plan for. I'll let you know when it exists and where.

Thank you for all your efforts!

--Tigersharke 13:39, 8 July 2012 (PDT)

Your request for "define numbering consecutively"- is this meant to be part of the Collation section of the style guidelines? I'm not sure if there is a certain 'best' or 'worst' way of doing it. Unless you have a certain example that you could give me to help with defining this in a general way?

--Tigersharke 13:39, 8 July 2012 (PDT)

I mean numbered lists (by using #).
The Style Guidelines are saying for Bullets that a hard enter between the items are needed (to ensure that the PDF and EPUB versions format correctly).
For example in Creating an Automated Installation with pc-sysinstall you can find the following code.

To create a custom installation, perform the following steps:

1. Text for step 1

2. Text for step 2

3. Text for step 3

These steps are discussed in more detail below.

And what is going on in EasyPBI?
An other variant (yes, i modified it also) is used in Printing#Manually Adding a Driver.
There is an other one in PC-BSD Wiki:Style Guidelines#External Hypertext Links. It is a mix of HTML and wiki-markup (or not?).
Please create rules for numbered lists. :-)
--Rg 21:07, 8 July 2012 (PDT)

Here is a response to some of those questions:

  1. The PC-BSD Wiki:Style Guidelines#External Hypertext Links is all wiki markup, although part of it does look like html because it uses < and > to enclose some things. I need to make parts of it bold to better clarify it. In addition to this, there are certain situations where it truly is a mix of wiki markup and html, such as the Wiki Site TODO page.
  2. At the moment, I do not believe there is a specific rule already being followed for when to use numbered lists. It would make sense to use them for specific step-by-step instruction, however, I do not believe that this is used much at all. I believe that the primary method of describing processes is entirely with words rather than numbered lists. I will have to skim through the handbook to see how it might best be used and clarify the conditions that would necessitate it.
  3. The EasyPBI page is missing a number of images, that automatically become red text to indicate this. The odd "2." you noticed seems to be a remnant of an edit, and not intentional. The page may not yet be as perfect as desired or may be incompletely modified, causing some of the consistency issues and other flaws.
  4. Beware, there are templates of various format on the wiki, including more than one way to make the tables. The intent with all variants is to eventually simplify and speed up editing. I will have to set aside somewhere to indicate which templates have been depreciated, or perhaps simply a "depreciated" category tag for those.

Thank you for your help and motivation toward getting things defined. It will help us all to stay consistent. I already now realize PC-BSD Wiki:Style Guidelines appears to incompletely apply to itself.

--Tigersharke 22:42, 8 July 2012 (PDT)

With regard to the use of hard enter for bullets, I am uncertain if or how this makes a difference because the wiki software will re-interpret all content anyways. I believe a more proper way of handling the "hard enter" would be to add a <br> tag.

--Tigersharke 01:27, 9 July 2012 (PDT)

Brand new template added to style guidelines- citelink now has its use for external links described. Other changes to the guidelines as well, and they will continue to be improved.

--Tigersharke 01:34, 11 July 2012 (PDT)

thin client page

Hey there..

I am curious whether you are able to successfully edit & save any edits to the Thin Client page. There is a weird bug of some sort that prevents me from editing the whole page or the first section, and being able to save it. If the content of the first section is all selected, you may see a few places where there appear to be extra spaces (at the end of lines, one is at the beginning of a blank line). I do not believe those are actually spaces, but something else which causes this error I describe.

Anyhow, either the page can be fixed by someone other than myself (no clue why I am lucky to be bitten by this bug), or at the very least, the external links within the page need to be switched to citelink format as described in the style guidelines.

Thank you for all your efforts!

--Tigersharke 00:46, 25 July 2012 (PDT)


I cannot see "to much spaces" or other strange things. So probably I cannot help, at all.

I changed the every wikipedia link namespace like to the citelink syntax.

--Rg 04:38, 25 July 2012 (PDT)

Those will work fine now. Thanks! For future interwiki type links, they can also use the citelink template in a shorter form (similar idea to usual interwiki link). The style guidelines lists the sites that I setup for this interwiki function, in the special external section.

--Tigersharke 13:51, 25 July 2012 (PDT)

All right! I am happy, that it works (fine)!

BTW: I am a friend of "simple" things (can be used by everyone). So I prefer the "style" of interwiki links (by using a namespace like syntax. Anyway thanks a lot for the (great) template. Of course I will use it, starting from now.

--Rg 15:57, 25 July 2012 (PDT)

categorizing pages

  • Pages that are part of the handbook will have these categories: handbook, macro topic (such as control panel), topic (such as bluetooth manager). Whether micro, nano, pico, or atto topics get categories as well, is not as clear. They *could* but since those are often more verbose, they would probably need to be made a bit more concise (few words, like no more than 2 or three) without losing detail.
  • Other pages on the wiki, may have the category pc-bsd wiki and a category of the topic it fits.
  • The category, categories is only for category pages and not to categorize normal pages.
  • Categorizing images- similar hierarchy would be used as with handbook pages, especially to add a category tag for the page the image appears on.
  • It is okay to create new categories by giving a page a new category membership. It will display a redlink for the category which can be used to make it official and add a description for the new category.

Exploring to see how things are already and discovering what exists are the best ways to learn what to do. I cannot claim that there is perfect consistency through the entire wiki, or even the entire handbook portion of the wiki, but hopefully there is enough consistency to understand the intent and the general rule being applied. I have tried to document things in the Style Guidelines, and various other places (ie, on templates or categories). It never hurts to ask when you are unsure, but as you've also noticed, recent changes will alert you to where you may take a look whether changes are needed (in other words, you can use your best judgement and 'go for it,' you won't permanently wreck anything :).

Thanks for your time and efforts on the wiki, it is certainly appreciated.

--Tigersharke 22:38, 29 July 2012 (PDT)

reminder for myself

  • nbsp
Personal tools