876
Comment: add todos
|
7579
suggest joining the debian-www channel/list
|
Deletions are marked like this. | Additions are marked like this. |
Line 13: | Line 13: |
* ''[[PackageManagement]]'' (portal) * ''[[Software]]'' (portal) * ''[[CommandLineInterface]]'' (portal) * ''[[SystemAdministration]]'' (portal) * ''[[DebianInstaller/Preseed]]'' * ''[[Packaging]]'' (portal) * ''[[Sound]]'' (portal) * ''[[Firefox]]'' * ''[[Printing]]'' (portal) * ''[[SecurityManagement]]'' (portal) ---- |
|
Line 17: | Line 32: |
* Macros: {{{DebPkg:}}}, {{{DebMan:1}}} | * RandomPage * Macros: {{{DebPkg:}}}, {{{DebMan:bash.1|bash}}} |
Line 19: | Line 35: |
* Add Wikipedia links if relevant | |
Line 20: | Line 37: |
=== TODO === | === External sources === |
Line 22: | Line 39: |
* https://wiki.debian.org/UseCdBurner * https://wiki.debian.org/CategoryPackageManagement * https://wiki.debian.org/AudioVideo * https://wiki.debian.org/Software |
* https://salsa.debian.org/nodiscc2-guest/awesome-linuxaudio -> {{{Multimedia}}} === Work in progress === * AptConfiguration * PackageManagementTools * [[DebianFirewall]], [[Firewalls]] * [[BTS]], [[bugreport]] * Add Arch Wiki links if relevant '''Obsolete pages:''' <<FullSearch(CategoryObsolete)>> '''Redundant pages:''' <<FullSearch(CategoryRedundant)>> '''Command line interface:'''<<FullSearch(CategoryCommandLineInterface)>> === Talks === {{{#!wiki yellow/solid 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 }}} {{{#!wiki green/solid 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 blue/solid :) I gave fullsearch a try to (see [[Game]] page for an illustration), so we're on the same line. * You may use the Cached version when you think you're done with the category. I admit I don't remember when the cache gets regenerated unless you explicitly click to do it. * You may add the lang:en search parameter, which means translators also have to replace it with the right one. That also means categories which are named after a language shouldn't exist (only some french ones existing IIRC). Using fullsearch has a few drawbacks, some Debian wiki pages mostly contain list of software, with comments... (lists with `DebPkg` shortcut) so if you switch to a `FullSearch` list, you won't be able to put comments on each line. Some people used them to "recommend" some packages over others but I don't think this should be the main purpose of a wiki. Also, making lists is the purpose of categories, so logically, pages shouldn't need the fullsearch macro to do that, and people would navigate using the categories. Right now there are a few redirections (url rewrite in wiki admin?), I believe they could be removed if we want to give back their purpose to categories. Right now I have no big idea, maybe I'll do nothing but if I attempt to join your efforts :) I may have an eye on the orphaned pages, as there should be none IMO. I also feel some pages content turned quite old or irelevant so we don't have to hesitate too much to delete their content. That's what I think you have been doing so it's probably no big news. I'm unsure these wiki issues have been discussed within Debian lately, I'm not part of any team, this should also clarify my words are in no way something official :) See you!}}} {{{#!wiki green/solid . You may use the Cached version when you think you're done with the category . add the lang:en search parameter Good, I will do that. . some Debian wiki pages mostly contain list of software, with comments... (lists with `DebPkg` shortcut) so if you switch to a `FullSearch` list, you won't be able to put comments on each line. I will probably not switch those pages, I mainly user `FullSearch` on portals: * Each page is attached to one or more categories * Each Category page redirects to the corresponding portal * The portal has plain paragraphs that introduce common topics; these paragraphs, in turn link the detailed pages about the subject. * At the bottom of the portal there is a `FullSearch` for the corresponding category - this ensures less frequent topics are also visible and discoverable from the portal - and can be later merged, or improved. Or a proper paragraph/link can be added to introduce them. We ''could'' use Category pages for this, but far less people will visit them, and it takes more maintenance. `FullSearch` on the corresponding portal is much more visible, and it "forces" us to keep the page list clean/short - something `lang:en` and the current cleanup will help solving. See for example CommandLineInterface where it makes content duplication/too many pages symptom very evident. When all pages from a category are cleanly linked from the corresponding portal page, `FullSearch` is indeed not needed. But this is almost never the case. . we don't have to hesitate too much to delete their content I read each candidate for deletion completely to make sure no interesting content would be lost, and move it to other pages if needed. . I'm unsure these wiki issues have been discussed within Debian lately I left a message on #debian-www IRC about this, and no one seems to disagree (got no answer at all :) ). So I guess it's fine, as long no one reverts my changes :) A plus! The [[Game]] page looks great! }}} {{{#!wiki pink/solid . I left a message on #debian-www IRC about this, and no one seems to disagree (got no answer at all :) You didn't stick around long enough for anyone to comment. Please keep your IRC client in the #debian-www channel and join the debian-www mailing list, there has been at least one discussion about you there: https://lists.debian.org/msgid-search/06092019183508.5a8f735e9444@desktop.copernicus.org.uk }}} |
Line 28: | Line 138: |
## Uncomment the next line if you are a wiki translator ## CategoryWikiTranslator |
PackageManagement (portal)
Software (portal)
CommandLineInterface (portal)
SystemAdministration (portal)
Packaging (portal)
Sound (portal)
Printing (portal)
SecurityManagement (portal)
Wiki consolidation/cleanup/maintenance
Macros: DebPkg:, DebMan:bash.1|bash
- Add Wikipedia links if relevant
External sources
Work in progress
- Add Arch Wiki links if relevant
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)
I gave fullsearch a try to (see Game page for an illustration), so we're on the same line.
- You may use the Cached version when you think you're done with the category. I admit I don't remember when the cache gets regenerated unless you explicitly click to do it.
- You may add the lang:en search parameter, which means translators also have to replace it with the right one. That also means categories which are named after a language shouldn't exist (only some french ones existing IIRC).
Using fullsearch has a few drawbacks, some Debian wiki pages mostly contain list of software, with comments... (lists with DebPkg shortcut) so if you switch to a FullSearch list, you won't be able to put comments on each line. Some people used them to "recommend" some packages over others but I don't think this should be the main purpose of a wiki. Also, making lists is the purpose of categories, so logically, pages shouldn't need the fullsearch macro to do that, and people would navigate using the categories. Right now there are a few redirections (url rewrite in wiki admin?), I believe they could be removed if we want to give back their purpose to categories.
Right now I have no big idea, maybe I'll do nothing but if I attempt to join your efforts I may have an eye on the orphaned pages, as there should be none IMO. I also feel some pages content turned quite old or irelevant so we don't have to hesitate too much to delete their content. That's what I think you have been doing so it's probably no big news.
I'm unsure these wiki issues have been discussed within Debian lately, I'm not part of any team, this should also clarify my words are in no way something official
See you!
- You may use the Cached version when you think you're done with the category
- add the lang:en search parameter
Good, I will do that.
some Debian wiki pages mostly contain list of software, with comments... (lists with DebPkg shortcut) so if you switch to a FullSearch list, you won't be able to put comments on each line.
I will probably not switch those pages, I mainly user FullSearch on portals:
- Each page is attached to one or more categories
- Each Category page redirects to the corresponding portal
- The portal has plain paragraphs that introduce common topics; these paragraphs, in turn link the detailed pages about the subject.
At the bottom of the portal there is a FullSearch for the corresponding category - this ensures less frequent topics are also visible and discoverable from the portal - and can be later merged, or improved. Or a proper paragraph/link can be added to introduce them.
We could use Category pages for this, but far less people will visit them, and it takes more maintenance. FullSearch on the corresponding portal is much more visible, and it "forces" us to keep the page list clean/short - something lang:en and the current cleanup will help solving. See for example CommandLineInterface where it makes content duplication/too many pages symptom very evident.
When all pages from a category are cleanly linked from the corresponding portal page, FullSearch is indeed not needed. But this is almost never the case.
- we don't have to hesitate too much to delete their content
I read each candidate for deletion completely to make sure no interesting content would be lost, and move it to other pages if needed.
- I'm unsure these wiki issues have been discussed within Debian lately
I left a message on #debian-www IRC about this, and no one seems to disagree (got no answer at all ). So I guess it's fine, as long no one reverts my changes
A plus!
The Game page looks great!
I left a message on #debian-www IRC about this, and no one seems to disagree (got no answer at all
You didn't stick around long enough for anyone to comment. Please keep your IRC client in the #debian-www channel and join the debian-www mailing list, there has been at least one discussion about you there:
https://lists.debian.org/msgid-search/06092019183508.5a8f735e9444@desktop.copernicus.org.uk