 |
Outras línguas Inglês ; Português (Portugal) |
Idiomas
Contents
Como é que funciona a lista de tarefas
Esta página tem como objetivo organizar o trabalho da equipa de documentos. Qualquer pessoa pertencente à equipa de documentos pode atualizar esta página e qualquer pessoa pertencente à comunidade da Mageia pode escrever uma página de documentação, listada ou não aqui.
If you want to create a page for the documentation, we are happy for you to take the initiative. Before doing this, it is preferable to check that no other page covers partially or completely the subject you want to document. Consider also modifying a page which seems to be incomplete. If you intend to modify a page substantially, it is a good idea to mention it either in the mailing list doc-discuss or directly with the original writer.
If you start to work on one of the topics below, please post in the mailing list doc-discuss the link to the page you started here, together with your name and current progress. This information should be updated frequently, to avoid duplication or multiple contributors working on the same topic in parallel.
All you need to know about tools, report pages, management, mailing list, contact and so on can be found in our Doc_Team_Portal. If you get lost in all these pages, just send an e-mail to the doc-discuss mailing list saying what you want to do and we will be happy to give you a simple procedure.
Please, when a topic is done, don't delete it but cross it off the list instead. It is more easy to follow the progress.
A documentação completa está dividida em secções:
- A ajuda oficial, subdivided in "Classical installer help", "Live installer help" and "MCC help"
- A Wiki with the same subdividing as its portal: Documentation
Cada secção está dividida em 3 partes:
- O que já existe gives links to where it is possible to find the already exiting documentation
- O que é urgente lists the top wishes
- Else to do lists the other wishes.
Ajuda Oficial
The Official help is important for the Mageia image and must be neat and tidy. Calenco is the tool we use for the Official help, see How_to_write_and_translate_Mageia_doc#Write_or_update_original_doc.
We are looking for a documentation that is not only a description of what can be seen on the screen, but a real relevant information with when possible:
- main features
- screen-shots
- examples
- common errors to avoid
- troubleshooting (how to do a good diagnosis, what to check, ...)
- known issues or bugs
Ajuda do instalador clássico
O que já existe
A ajuda oficial do «Instalador»
O que é urgente
Always keep the official help up to date, write here what is not:
- To carry out the missing screenshots Missing_MCC_screenshots
- ...
Else to do
Ajuda do instalador «Live»
O que já existe
O que é urgente
Always keep the official help up to date, write here what is not:
- To carry out the missing screenshots Missing_MCC_screenshots
- ...
Else to do
Ajuda MCC
O que já existe
The official MCC help
See also the report page Calenco_Draktools
O que é urgente
1 - Are still missing:
- drakinviictus
- draknetprofile
- drakxservices
- drakeups
2 - And some others have to be completed and/or checked:
- diskdrake --fileshare
- diskdrake --smb
- drakboot --boot
- draknetcenter (Network Manager, roaming)
- drakconnect (missing exotic devices)
3 - To carry out the missing screenshots Missing_MCC_screenshots
Else to do
- All the MCC non default tools that aren't already written (see Calenco_Draktools#Non_default_MCC_tools)
- All the other
Mageiatools- mgaapplet
- netapplet
- ....
Documentação da Wiki
For practical information, have a look to How_to_write_a_wiki_page
Always begin by reading the existing pages that are near your subject, you will find material, may be a new section is enough/better instead of a new page or a former page will become obsolete. That demands some search.
Dicovery of Linux and Mageia
O que já existe
This page first section Documentation#Discovery_of_Linux_and_Mageia_.28For_newcomers.29
O que é urgente
1 - To have a page about each desktop environment.
The first time a newcomer looks at his/her brand new desktop, it is not obvious that there are components of it that are Mageia and others that come from the Desktop Environment, especially if the user has come from Windows where everything is Windows.
We would like to have for each DE a simple page with:
- a large screen-shot showing:
- a landmark on the
Mageiatools (mgaapplet, netapplet, ...) - a view on the menu
- a landmark on the
- how to get the DE tools
- how to get the MCC tools
- for the most important features, what can be configured by the MCC tools, or by the DE tools, or both,
- a link towards the DE website
- everything else that could be discussed on the mailing list
2 - Update every page quoting LXDE, this DE is soon obsolete.
Else to do
Any help to welcome the newcomers
Instalação
O que já existe
This page Installation section Documentation#Installation
O que é urgente
1 - Which hardware for Mageia
2 - Choosing a desktop, may be connected with the previous line?
3 - Partitioning, idea of pages name:
4 - Creating a persistent USB Stick. A discussion[1] in forum is to formalize.
Else to do
1 - Preparing a medium
2 - Using the test distribution Cauldron
3 - Installing and removing software from Mandriva. To have a look to this page before deleting. Is there anything to save ?
4 - Installing and configuring the bootloader:
- Grub2-efi_and_Mageia to be checked
- create a new page about Grub2 and MSDOS partitions
5 - Update every page quoting the Dual Arch medium, it will soon disappear.
6 - Installing_Mageia to be revised or deleted
MCC
O que já existe
This section about MCC tools: Documentation#MCC_tools_.28also_called_Draktools.29
O que é urgente
Else to do
Setting and using Mageia
Software
O que já existe
This section about software: Documentation#MCC_tools_.28also_called_Draktools.29
O que é urgente
1 - Network sharing. NFS - Samba, etc.
Else to do
1 - Social networks
2 - The page about the superuser Root must be completed
Hardware
O que já existe
This section about hardware: Documentation#Hardware
O que é is urgente
1 - Configuring and using a 3G or 4G access
2 - Which hardware for Mageia: Explain that the most of the hardware is supported, which hardware needs special drivers or is known for not working.
3 - systemd: The aim of systemd, how it works, main commands to get infos...
4 - Sound troobleshooting. Pulse Audio - pavucontrol - Alsa - Phonon - KMix - alsamixer - Drivers etc.
Else to do
1 - Installing proprietary graphic drivers (Nvidia and ATI)
2 - Configuring the hostname
3 - How to mount a USB stick. Seems to be a draft, to be completed
A Comunidade
O que já existe
This section about the Community: Documentation#The_Community
O que é urgente
1 - How to use Git. Seems to be a draft, to be completed.
Else to do
Outras ações de documentação
(We can list here the decided actions that aren't included either in Official help or Wiki documentation.)
Docteam meeting agenda submissions
- Our meeting agenda submissions page.
- Regardless of date order, perhaps suitable topics (esp if there are more than enough to be dealt with in one meeting) could be selected by: priority topics; topics not dealt with in the previous meeting due to lack of time; topics which are related?
- Meeting Chair(s) - team leader to update the status of submissions?
