Help:Overbrengen

Ga naar: navigatie, zoeken
De Richtlijnen voor overbrengen beschrijven essentiƫle na te volgen stappen om een geleidelijke en efficiƫnte overgang van artikelen uit onze oude wiki te verzekeren.

Begrijp de verschillen met de oude wiki

De oude wiki was de eerste wiki die het openSUSE project ooit had. We zijn gestart zonder een echt concept en zonder de ervaring waarvoor mensen het hulpmiddel wiki zouden gebruiken. In de loop van zijn 5 jarig bestaan is het voor van alles gebruikt: als pagina voor alles en voor marketing, nieuws bekendmaken, samenwerkingsruimte, hardware/kennis database, agenda, aanplakruimte, teamcommunicatie enzovoort. het komt er op neer dat het gehele openSUSE project in de wiki was te vinden en dat het werd gebruikt voor elke mogelijke taak. Dit was zo moeizaam dat we eindigden met het eenvoudig dumpen van informatie.

Dit artikel is nog maar gedeeltelijk vertaald. Als u mee wilt helpen met vertalen lees dan Wiki vertalen naar het Nederlands.

People opened up http://en.opensuse.org/Foobar in their browser and added content about Foobar. In most of the cases Foobar was an article about Foobar and a solution to a problem they had with it. In some cases Foobar was a group of articles about a specific topic. In almost no case people made sure that Foobar was correctly integrated with the rest of the wiki. There was no structure, no way to navigate and no consistent look and feel.

The opposite of these things described above are what we try to bring to this instance now. We want to respect that the wiki is a tool and use it for what its good for: collaborative editing for everybody. We don't want to use it for everything that is happening in the openSUSE project. So we have this 4 pillar strategy:


Structuur

De inhoud van deze wiki is onderverdeeld per topic in een aantal groepen die naamruimten worden genoemd en die overeenkomen met een aantal fundamentele interesses van wiki bezoekers en gebruikers. De drie grote groepen zijn:

  • Project en distributie presentatie:
    • Locatie: In de Main naamruimte waar artikelen geen voorvoegsel hebben.
    • Topic: Presentatie van de laatste uitgave van de openSUSE Distributie. Dit kunt u beschouwen als de productbrochure waar het project en zijn onderdelen worden besproken.
    • Doelgroep Mensen die nieuw zijn bij openSUSE en misschien bij Linux in het algemeen.
  • Support Database (SDB):
    • Locatie: In de SDB naamruimte waar artikelen het voorvoegsel SDB: hebben.
    • Topic: Schriftelijke ondersteuning, zoals alternatieve installatie instructies (andere, niet ondersteunde methoden om openSUSE te installeren of te upgraden), installatie van programma's van derden (die geen onderdeel zijn van openSUSE, maar waar veel gebruikers toch gebruik van maken), configuratie van programma's, systeemdiensten en hardware die niet volledig wordt ondersteund door een distributie, en tenslotte workarounds voor de meest vervelende bugs.
    • Doelgroep: Mensen die een probleem hebben met het installeren en gebruiken van openSUSE of een onderdeel hiervan en die schriftelijke instructies zoeken om hun probleem op te lossen.
  • Vrijwilligers (contributors):
    • Locatie: In de openSUSE naamruimte waar artikelen het voorvoegsel openSUSE: hebben.
    • Topic: Alles wat teams van vrijwilligers nodig hebben, van werkbestanden, team introducties, plannen, ontmoetingen, ontmoetingsverslagen tot to do lijsten, etc.
    • Doelgroep:Vrijwilligers die bijdragen aan openSUSE.

Navigatie

Navigatie gebeurt door middel van middelen die typisch zijn aan elke wiki, maar er zijn ook portalen. Portalen zijn toegangspunten voor een specifiek onderwerp, gelijkaardig aan de homepagina. Ze zorgen voor een overzicht over een onderwerp en gidsen lezers naar de inhoud die ze zoeken. Dit kan zowel een ander portaal zijn als een individueel artikel. Ook categorisering is zeer belangrijk voor onze wiki navigatie, dewelke het mogelijk maakt om automatisch overzichtspagina's en navigatiestructuren te genereren. Met deze regels voor navigatie verzekeren we dat onze lezers de inhoud vinden die we produceren.

Opmaak

Het opmaken van inhoud gebeurt door middel van sjablonen. Er zijn twee soorten, sjablonen voor een specifiek type van artikel zoals het algemene artikelsjabloon, hetgeen wordt gebruikt voor Portalen of voor ondersteuningsdatabase artikelen en sjablonen voor het opmaken van herhaaldelijk terugkerende inhoud in artikelen zoals introductie en infoboxen, tips en instructies of externe bronnen en items. Met deze regels over opmaak verzekeren we dat mensen de inhoud die we produceren begrijpen.

Kwaliteitscontrole

Prominente naamruimtes in deze wiki worden onderworpen aan een kwaliteitscontrole (EN:Quality Assurance) of kortweg QA proces om ervoor te zorgen dat ze voldoen aan de vereiste kwaliteit. Dit QA proces gebeurt via een systeem die de mogelijkheid biedt om verschillende revisies van artikelen in parallel te hebben en Ć©Ć©n goedgekeurd door het Wiki team. Het limiteert het aanmaken van nieuwe inhoud niet, maar staat toe om standaard alleen inhoud van kwaliteit weer te geven. Met dit proces verzekeren we dat de bezoekers die een eerste keer komen aangetrokken worden en blijven op een pagina.

Vertaling

Een belangrijk onderdeel van ons concept is dat wiki inhoud toegankelijk moet zijn voor mensen die geen Engels kunnen lezen of schrijven om eventueel bij te dragen aan de artikelen. We hebben meerdere wiki vertaal projecten lopende en we zullen er meer toevoegen wanneer openSUSE gemeenschappen die gebruik maken van andere talen sterk genoeg zijn om de vertaling aan te kunnen en later gewoon verder kunnen gaan met het op regelmatige basis onderhouden van de wiki.

We hebben ook een multi-talen wiki die gebruikt kan worden om beginnende vertalingen van verplichte artikelen onder te brengen in afwachting van de oprichting van een vertaalde wiki, of om enkel een paar artikelen te vertalen.

Before everything else, please make sure you understand this strategy and the differences to the old wiki. It makes no sense working in this wiki with the thinking of the old instance. You will just get confused and confuse others.

How to decide which articles to transfer

Scratch your itch

The open source incentive "Scratch Your Itch" is a nice way to decide which article to migrate. Are you missing the description of a distribution feature? The solution to a problem? The page of your team? Then transfer it!

Popular pages

If you are not missing anything but still want to help there is an automatically generated list of popular pages in the old instance to give you an idea what readers are looking for, have a look if something that is on this list is not transferred yet.

How to transfer articles

First you should check the content of the articles you want to transfer. Please do not transfer articles related to obsolete technology (e.g. ZMD), support database articles exclusively about "out of maintenance" versions (older than 11.0), pages of teams/projects that are no active any more (e.g. JackLab) or similar things. We only want to transfer content that matters from now on going forward and we do not want to be backward compatible to the old wiki. In doubt, ask a wiki team members on #opensuse-wiki IRC channel or on the openSUSE-wiki mailing list.

Whole topics

Best practice is to choose a topic and transfer every article that belongs to this topic. This way you can ensure that all required articles are transferred in a consistent way. You should start with the Portal. Often a topic has an introduction page already, just not in the Portal format. See for instance

Adapting these pages to the Portal format will not only make the Portal ready but will also give you an overlook over the articles important for this topic. After you have adapted the styling you will have a lot of red links on the Portal, follow them and transfer the individual articles. If the individual article uses a Template that is not there yet try to find an equivalent on Help:Standard_templates. General styling help for content you find on Help:Style. In the end make sure that your Portal is reachable from the Hoofdpagina, either directly or through another Portal. Also make sure that all individual articles you have transferred are reachable from your portal. And that all pages you have created are at least in one Category.

Individual articles

If you are transferring an individual article because the Portal or individual article you can link it from already exists just skip all the Portal steps from the description above.