1664
Comment:
|
3108
|
Deletions are marked like this. | Additions are marked like this. |
Line 53: | Line 53: |
{{{ | |
Line 62: | Line 63: |
}}} Hi ccts, for many years I found it was hard to search for information on the debian wiki, pages are not discoverable, many pages were drafts, there was duplicate/contradictory information... so recently I started following some broad guidelines: * Make the wiki more readable, navigable, accessible, refresh some older content * Deduplicate/merge content across pages on topics I understand, or use links. * Merge pages that have almost no content with their "parent" page, in general avoid creating extra pages when the content could fit in an existing page. No one will maintain them. * Standardize portals, use them as landing pages that any user from any knowledge level can understand and find information from. * Add categories to all pages, Redirect CategoryCategory pages to their respective portal, add {{{fullsearch}}} macros for the Category on the portal page * Standardize page names/formatting, spacing, link syntax, link cleanup... (EditorGuide) * I have amassed a good amount of Debian docs on a personal wiki, wanted to merge some of it here, but couldn't cleanly do it without some refactoring (still ongoing) * Everything linked from FrontPage should be high quality content * There is some good general advice at https://wiki.c2.com/?GoodStyle https://wiki.c2.com/?RefactoringWikiPages * Delegate explanation/description of general concepts to Wikipedia (copy intro, link to WP page) |
Wiki consolidation/cleanup/maintenance
Macros: DebPkg:, DebMan:bash.1|bash
External sources
Work in progress
Obsolete pages:
- Alioth
- CategoryEmdebian
- CategoryGeolocation
- CategoryObsolete
- Debian-HA/ClustersFromScratch
- DebianCustomCD
- DebianEdu/HowTo/LtspBootchart
- DebianInstall
- DebianInstallPolish
- DebianWiki/Administration
- DecentralizedInfrastructure
- LDAP/Kerberos
- LDAP/MigrationTools
- LiveCD
- MD5
- NetworkFAQ
- Samba/BuildingALinuxDomain
- Samba/ClientSetup
- Samba/Dirvish
- Samba/DomainController
- Samba/ServerSimple
- Teams/Webmaster/WebsiteDiscussion
- es/Compartir_red_fisica_con_WiFi
- fr/Alioth
- fr/DebianInstall
- it/Alioth
- it/DebianInstall
- nodiscc
- pt_BR/Alioth
- pt_BR/BuildingALinuxDomain
- pt_BR/DebianInstall
- pt_BR/Samba/ClientSetup
- ro/DebianInstall
- uk/WikiTag
- zh_CN/DebianInstall
Redundant pages:
- AlsaMidi
- AptMove
- BTS/BugTag
- BTS/HowTo
- Backup
- BackupAndRecoveryWork
- Bash
- BourneShell
- BrowserApps
- BugReport
- BugReport/WorkingOn
- BugTriage
- CategoryRedundant
- CommandLine
- CommandsCLI
- DebianFirewall
- DebianInstaller/SataRaid
- DebianInstaller/SoftwareRaidRoot
- DebianSoftware
- DebianWiki/Administration
- DefaultWebBrowser
- EduCheesetracker
- EduSoundtracker
- Firefox
- Firewalls
- HowToPackageForDebian
- HowtoUseBTS
- Icedove
- JabberClients
- LCD
- Linux volume management
- LinuxRaidForAdmins
- Manual-Howto
- MidiHardware
- Mozilla
- MultimediaCodecs
- NetworkApplication
- NetworkFAQ
- Part-UUID
- Peer2Peer
- QuickInstall
- RemoteFiles
- ShellCommands
- ShellConfiguration
- ShellTricks
- SoftwareRAID
- Tar
- TheUnixWay
- UserInterface
- WHEEL/PAM
- WindowsEquivalent
- XCP
- Zg2ShellStartup
- ar/CommandLineInterface
- bn/CommandLineInterface
- ccts
- coreutils
- de/Manual-Howto
- de/NetworkApplication
- deb
- es/CommandLineInterface
- es/TheUnixWay
- fr/Bash
- fr/HowtoUseBTS
- fr/ShellTricks
- fr/TheUnixWay
- ftp.debian.org
- id/CommandLineInterface
- it/BTS/HowTo
- it/Bash
- it/CommandLine
- it/CommandsCLI
- it/DebianFirewall
- it/DebianSoftware
- it/Firefox
- it/Firewalls
- it/HowToPackageForDebian
- it/JabberClients
- it/Manual-Howto
- it/MultimediaCodecs
- it/NetworkApplication
- it/Part-UUID
- it/Peer2Peer
- it/QuickInstall
- it/RemoteFiles
- it/ShellCommands
- it/ShellConfiguration
- it/ShellTricks
- it/TheUnixWay
- it/UserInterface
- it/WindowsEquivalent
- it/coreutils
- it/deb
- it/rootfs
- ko/CommandLineInterface
- ms/CommandLineInterface
- nodiscc
- pamusb
- partclone
- pt_BR/BTS/BugTag
- pt_BR/BTS/HowTo
- pt_BR/Bash
- pt_BR/BugReport
- pt_BR/DebianInstaller/SataRaid
- pt_BR/Firefox
- pt_BR/HowToPackageForDebian
- pt_BR/Part-UUID
- pt_BR/QuickInstall
- pt_BR/ShellCommands
- pt_BR/TheUnixWay
- pt_BR/deb
- rootfs
- ru/CommandLineInterface
- ru/Part-UUID
- sv/CommandLineInterface
- uk/RemoteFiles
- uk/WikiTag
- vi/commandlineinterface
- zh_CN/CommandLineInterface
- zh_CN/HowToPackageForDebian
- zh_CN/Manual-Howto
Command line interface:
- Bash
- BashColors
- BourneShell
- BurnCd
- CategoryCommandLineInterface
- CategoryFrCommandLineInterface
- CommandLine
- CommandLineInterface
- CommandsCLI
- Compression
- Console
- DvdRwTools
- EricVeirasGalisson/ChangeLog
- Fish
- Lynx
- ManualPage
- Ncurses
- Permissions
- Shell
- ShellCommands
- ShellConfiguration
- ShellScript
- ShellToolTricks
- ShellTricks
- TerminalEmulator
- TheUnixWay
- UserInterface
- WhereIsIt
- Zg2ShellStartup
- ar/CommandLineInterface
- bn/CommandLineInterface
- chgrp
- coreutils
- cs/CommandLineInterface
- eo/UDF
- es/CommandLineInterface
- es/Shell
- es/TheUnixWay
- es/w3m
- fr/Bash
- fr/BurnCd
- fr/CommandLineInterface
- fr/Compression
- fr/Console
- fr/DashAsBinSh
- fr/Lynx
- fr/ManPage
- fr/Ncurses
- fr/Shell
- fr/ShellTricks
- fr/TerminalEmulator
- fr/TheUnixWay
- fr/motd
- fr/w3m
- git
- id/CommandLineInterface
- it/Bash
- it/BurnCd
- it/CommandLine
- it/CommandLineInterface
- it/CommandsCLI
- it/Compression
- it/Console
- it/DvdRwTools
- it/Lynx
- it/Ncurses
- it/Permissions
- it/Shell
- it/ShellCommands
- it/ShellConfiguration
- it/ShellScript
- it/ShellToolTricks
- it/ShellTricks
- it/TheUnixWay
- it/UserInterface
- it/WhereIsIt
- it/coreutils
- it/git
- it/motd
- it/w3m
- ja/CommandLineInterface
- ko/CommandLineInterface
- motd
- ms/CommandLineInterface
- pt_BR/Bash
- pt_BR/CommandLineInterface
- pt_BR/Console
- pt_BR/Lynx
- pt_BR/Ncurses
- pt_BR/Shell
- pt_BR/ShellCommands
- pt_BR/ShellConfiguration
- pt_BR/ShellScript
- pt_BR/TerminalEmulator
- pt_BR/TheUnixWay
- pt_BR/w3m
- ro/ShellCommands
- ru/Bash
- ru/BashColors
- ru/CommandLineInterface
- ru/ShellCommands
- ru/terminal
- sv/CommandLineInterface
- uk/CommandLineInterface
- uk/Lynx
- uk/TerminalEmulator
- uk/w3m
- vi/commandlineinterface
- w3m
- zh_CN/Bash
- zh_CN/CommandLineInterface
Talks
Hi nodiscc, It looks like you have some good plans against the wiki mess, I haven't followed the details but I can only agree with the cleaning work, orphaned pages, not categorized ones, duplicate ones and what else. If you want we can discuss this somewhere, it might help if we're several agreeing on what needs to be done. See you! ccts
Hi ccts, for many years I found it was hard to search for information on the debian wiki, pages are not discoverable, many pages were drafts, there was duplicate/contradictory information... so recently I started following some broad guidelines:
- Make the wiki more readable, navigable, accessible, refresh some older content
- Deduplicate/merge content across pages on topics I understand, or use links.
- Merge pages that have almost no content with their "parent" page, in general avoid creating extra pages when the content could fit in an existing page. No one will maintain them.
- Standardize portals, use them as landing pages that any user from any knowledge level can understand and find information from.
Add categories to all pages, Redirect CategoryCategory pages to their respective portal, add fullsearch macros for the Category on the portal page
Standardize page names/formatting, spacing, link syntax, link cleanup... (?EditorGuide)
- I have amassed a good amount of Debian docs on a personal wiki, wanted to merge some of it here, but couldn't cleanly do it without some refactoring (still ongoing)
Everything linked from FrontPage should be high quality content
There is some good general advice at https://wiki.c2.com/?GoodStyle https://wiki.c2.com/?RefactoringWikiPages
- Delegate explanation/description of general concepts to Wikipedia (copy intro, link to WP page)