Differences between revisions 32 and 35 (spanning 3 versions)
Revision 32 as of 2019-09-07 14:08:13
Size: 1664
Editor: ccts
Comment:
Revision 35 as of 2019-09-07 18:32:55
Size: 3108
Editor: nodiscc
Comment:
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

External sources

Work in progress

Obsolete pages:

Redundant pages:

  1. AlsaMidi
  2. AptMove
  3. BTS/BugTag
  4. BTS/HowTo
  5. Backup
  6. BackupAndRecoveryWork
  7. Bash
  8. BourneShell
  9. BrowserApps
  10. BugReport
  11. BugReport/WorkingOn
  12. BugTriage
  13. CategoryRedundant
  14. CommandLine
  15. CommandsCLI
  16. DebianFirewall
  17. DebianInstaller/SataRaid
  18. DebianInstaller/SoftwareRaidRoot
  19. DebianSoftware
  20. DebianWiki/Administration
  21. DefaultWebBrowser
  22. EduCheesetracker
  23. EduSoundtracker
  24. Firefox
  25. Firewalls
  26. HowToPackageForDebian
  27. HowtoUseBTS
  28. Icedove
  29. JabberClients
  30. LCD
  31. Linux volume management
  32. LinuxRaidForAdmins
  33. Manual-Howto
  34. MidiHardware
  35. Mozilla
  36. MultimediaCodecs
  37. NetworkApplication
  38. NetworkFAQ
  39. Part-UUID
  40. Peer2Peer
  41. QuickInstall
  42. RemoteFiles
  43. ShellCommands
  44. ShellConfiguration
  45. ShellTricks
  46. SoftwareRAID
  47. Tar
  48. TheUnixWay
  49. UserInterface
  50. WHEEL/PAM
  51. WindowsEquivalent
  52. XCP
  53. Zg2ShellStartup
  54. ar/CommandLineInterface
  55. bn/CommandLineInterface
  56. ccts
  57. coreutils
  58. de/Manual-Howto
  59. de/NetworkApplication
  60. deb
  61. es/CommandLineInterface
  62. es/TheUnixWay
  63. fr/Bash
  64. fr/HowtoUseBTS
  65. fr/ShellTricks
  66. fr/TheUnixWay
  67. ftp.debian.org
  68. id/CommandLineInterface
  69. it/BTS/HowTo
  70. it/Bash
  71. it/CommandLine
  72. it/CommandsCLI
  73. it/DebianFirewall
  74. it/DebianSoftware
  75. it/Firefox
  76. it/Firewalls
  77. it/HowToPackageForDebian
  78. it/JabberClients
  79. it/Manual-Howto
  80. it/MultimediaCodecs
  81. it/NetworkApplication
  82. it/Part-UUID
  83. it/Peer2Peer
  84. it/QuickInstall
  85. it/RemoteFiles
  86. it/ShellCommands
  87. it/ShellConfiguration
  88. it/ShellTricks
  89. it/TheUnixWay
  90. it/UserInterface
  91. it/WindowsEquivalent
  92. it/coreutils
  93. it/deb
  94. it/rootfs
  95. ko/CommandLineInterface
  96. ms/CommandLineInterface
  97. nodiscc
  98. pamusb
  99. partclone
  100. pt_BR/BTS/BugTag
  101. pt_BR/BTS/HowTo
  102. pt_BR/Bash
  103. pt_BR/BugReport
  104. pt_BR/DebianInstaller/SataRaid
  105. pt_BR/Firefox
  106. pt_BR/HowToPackageForDebian
  107. pt_BR/Part-UUID
  108. pt_BR/QuickInstall
  109. pt_BR/ShellCommands
  110. pt_BR/TheUnixWay
  111. pt_BR/deb
  112. rootfs
  113. ru/CommandLineInterface
  114. ru/Part-UUID
  115. sv/CommandLineInterface
  116. uk/RemoteFiles
  117. uk/WikiTag
  118. vi/commandlineinterface
  119. zh_CN/CommandLineInterface
  120. zh_CN/HowToPackageForDebian
  121. zh_CN/Manual-Howto

Command line interface:

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)


CategoryHomepage