The Software Heritage wiki contain crowd-sourced documentation but is not very visible.
With this task we search for a decision-process to triage wiki pages into four categories:
1. should be in website (visibility for visitors)
2. should be in docs (visibility for users/contributors)
3. should stay as wiki page (with motivation)
4. should be removed
Please edit this task or add comments with the wiki page and the following properties:
| wiki page | for who (visitor/user/contributor) | can be attached to another page? | category (1/2/3) | possible solution | maintenance frequency |
|------------|-----------------------------------------|----------------------------------------|----------------------|---------------------|-----------------------------|
|[[ https://wiki.softwareheritage.org/wiki/Archive | Archive]] | ? | ? | 4 (almost empty)| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Best_practices_using_metadata | Best practices using metadata]] | contributor | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Cheatsheet | Cheatsheet]] | ? | 4 | 4 (redirect to empty page, orphan)| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/ClearlyDefinedObject | ClearlyDefinedObject]] | contributor (dev only) | ? | 3 (scratchpad for Tushar)| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/CodeMeta | CodeMeta]] | contributor | ? | 4 (outdated)| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Code_citation | Code citation]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Code_hosters | Code hosters]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Code_of_conduct | Code of conduct]] | user & contributor | ? | 1 (no reason for it to be editable)| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Code_search | Code search]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Coding_guidelines | Coding guidelines]] | contributor (dev only) | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Compression_ratio | Compression ratio]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Content_archiver_blueprint | Content archiver blueprint]] | contributor | ? | 4 (almost empty, outdated)| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Contributor_License_Agreement | Contributor License Agreement]] | contributor | ? | 1 (no reason for it to be editable)| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Debian_packaging | Debian packaging]] | contributor | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Easy_hacks | Easy hacks]] | contributor | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/External_contribution_integration | External contribution integration]] | contributor | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Forges | Forges]] | contributor | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Glossary | Glossary]] | everyone | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Graph_Dataset_on_Amazon_Athena | Graph Dataset on Amazon Athena]] | user (dev only) | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Je_suis_GPL | Je suis GPL]] | ? (dev only) | ? | 4 (almost empty, has a git repo with a readme)| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Licensing | Licensing]] | ? | ? | ? (orphan)| ? | outdated (2 years) |
|[[ https://wiki.softwareheritage.org/wiki/Local_elasticsearch | Local elasticsearch]] | ? (dev only) | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Lost_code | Lost code]] | visitor | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Main_Page | Main Page]] | everyone | ? | 3 (homepage of the wiki)| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Manifests | Manifests]] | ? | ? | 4 (almost empty)| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Metadata_initiatives | Metadata initiatives]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Original_Main_Page | Original Main Page]] | ? | ? | 4 (outdated)| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Presentation_with_org_beamer | Presentation with org beamer]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Python_module_layout | Python module layout]] | contributor (dev only) | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Python_package_layout | Python package layout]] | contributor (dev only) | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Python_style_guide | Python style guide]] | contributor (dev only) | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Repository_snapshot_objects | Repository snapshot objects]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Software_Catalogs | Software Catalogs]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Software_heritage | Software heritage]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Software_Heritage | Software Heritage]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Software_Heritage_archive | Software Heritage archive]] | ? | ? | 4 (almost empty)| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Software_Heritage_cheatsheet | Software Heritage cheatsheet]] | ? | ? | 4 (almost empty, orphan)| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Software_Heritage_identifiers | Software Heritage identifiers]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Software_Heritage_licensing | Software Heritage licensing]] | ? | ? | 4 (redirect, orphan)| ? | outdated (2 years) |
|[[ https://wiki.softwareheritage.org/wiki/Software_Heritage_requirements | Software Heritage requirements]] | ? | ? | ?| ? | outdated (4 years) |
|[[ https://wiki.softwareheritage.org/wiki/Sphinx_gotchas | Sphinx gotchas]] | contributor | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Statistics | Statistics]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Statistics/Content_size | Statistics/Content size]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Status_page | Status page]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Suggestion_box:_source_code_to_add | Suggestion box: source code to add ]]| visitor & contributor | ? |3 (easier to edit and see who edited the page)| ? |medium|
|[[ https://wiki.softwareheritage.org/wiki/Suggestion_box:_source_code_to_add/Debian_derivatives | Suggestion box: source code to add/Debian derivatives]] | visitor & contributor | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Suggestion_box:_source_code_to_add/KDE | Suggestion box: source code to add/KDE]] | visitor & contributor | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Talks | Talks ]] | visitor | Publications on site?| 1 ? | add link to annex |high|
|[[ https://wiki.softwareheritage.org/wiki/Testing_the_archive_features | Testing the archive features]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Vault_Blueprint | Vault Blueprint]] | ? | ? | 4 (outdated)| ? | ? |
# pages about tools used to work on SWH
(ie. tools used to work together, not tools used by the archive)
| wiki page | for who (visitor/user/contributor) | can be attached to another page? | category (1/2/3) | possible solution | maintenance frequency |
|------------|-----------------------------------------|----------------------------------------|----------------------|---------------------|-----------------------------|
|[[ https://wiki.softwareheritage.org/wiki/Arcanist | Arcanist]] | contributor (git only) | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Arcanist_setup | Arcanist setup]] | contributor (git only) | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Code_review | Code review]] | contributor (dev only) | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Code_review_in_Phabricator | Code review in Phabricator]] | contributor (dev only) | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Continuous_Integration | Continuous Integration]] | contributor (dev only) | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Continuous_integration | Continuous integration]] | contributor (dev only) | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Differential | Differential]] | contributor | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Forge | Forge]] | contributor | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Git | Git]] | contributor (git only) | ? | 4 (orphan + almost empty)| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Git_repositories | Git repositories]] | contributor (git only) | ? | 4 (orphan + almost empty)| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Git_style_guide | Git style guide]] | contributor (git only) | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/HedgeDoc | HedgeDoc]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/IRC | IRC]] | everyone | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/IRC_channels | IRC channels]] | everyone | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Jenkins | Jenkins]] | contributor (git only) | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Mailing_lists | Mailing lists]] | everyone | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Phabricator | Phabricator]] | contributor | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Phabricator_callsign_naming_convention | Phabricator callsign naming convention]] | contributor | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Private_wiki | Private wiki]] | contributor | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Public_wiki | Public wiki]] | everyone | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Report_issues_on_phabricator | Report issues on phabricator]] | user | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Wiki | Wiki]] | ? | ? | 3 (it's about the wiki itself)| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Wiki_editing_conventions | Wiki editing conventions]] | contributor | ? | 3 (it's about the wiki itself)| ? | ? |
# bibliography + pages about other organizations/projects
| wiki page | for who (visitor/user/contributor) | can be attached to another page? | category (1/2/3) | possible solution | maintenance frequency |
|------------|-----------------------------------------|----------------------------------------|----------------------|---------------------|-----------------------------|
|[[ https://wiki.softwareheritage.org/wiki/Archive.org | Archive.org]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Archive_Team | Archive Team]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Archiveteam | Archiveteam]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Conferences | Conferences]] | visitor | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/EGI | EGI]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/European_projects | European projects]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/GHTorrent | GHTorrent]] | contributor | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/GitHub | GitHub]] | ? | ? | 4 (empty)| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/GitTorrent | GitTorrent]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Internet_Archive | Internet Archive]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Internet_Memory_Foundation | Internet Memory Foundation]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Markos | Markos]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/MUSE | MUSE]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Onedata.org | Onedata.org]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/POCOS | POCOS]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Related_companies | Related companies]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Related_conferences | Related conferences]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Related_cultural_heritage_initiatives | Related cultural heritage initiatives]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Related_digital_preservation_initiatives | Related digital preservation initiatives]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Related_heritage_initiatives | Related heritage initiatives]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Related_reproducibility_initiatives | Related reproducibility initiatives]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Related_research | Related research]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Related_technology | Related technology]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Reproducibility_of_science | Reproducibility of science]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Reproducible_research | Reproducible research]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/SWORD_protocol | SWORD protocol]] | ? | ? | 2 (with swh-deposit)| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Schema.org | Schema.org]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Software_is_pervasive_in_Science | Software is pervasive in Science]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Software_catalogs | Software catalogs]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Software_ontologies | Software ontologies]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Software_repositories | Software repositories]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/TOTEM | TOTEM]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/The_Internet_Memory_Foundation | The Internet Memory Foundation]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/The_Web_Archive | The Web Archive]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/VITAM | VITAM]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/WARC | WARC]] | ? | ? | ?| ? | ? |
# pages about working groups
| wiki page | for who (visitor/user/contributor) | can be attached to another page? | category (1/2/3) | possible solution | maintenance frequency |
|------------|-----------------------------------------|----------------------------------------|----------------------|---------------------|-----------------------------|
|[[ https://wiki.softwareheritage.org/wiki/Distribution_Replication_and_Query | Distribution Replication and Query]] | contributor | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Ethical_and_Legal_Issues_and_Environment | Ethical and Legal Issues and Environment]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Metadata_and_Linked_Data | Metadata and Linked Data]] | | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Modeling_and_Ingesting_Version_control_systems | Modeling and Ingesting Version control systems]] | contributor | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Open_Access_and_Data | Open Access and Data]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Process | Process]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Reproducibility_of_Software | Reproducibility of Software]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Scientific_API | Scientific API]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Source_Discovery_and_Ingestion | Source Discovery and Ingestion]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/WG/Distribution_Replication_and_Query | WG/Distribution Replication and Query]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/WG/Ethical_and_Legal_Issues_and_Environment | WG/Ethical and Legal Issues and Environment]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/WG/Metadata_and_Linked_Data | WG/Metadata and Linked Data]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/WG/Modeling_and_Ingesting_Version_control_systems | WG/Modeling and Ingesting Version control systems]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/WG/Open_Access_and_Data | WG/Open Access and Data]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/WG/Reproducibility_of_Software | WG/Reproducibility of Software]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/WG/Scientific_API | WG/Scientific API]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/WG/Source_Discovery_and_Ingestion | WG/Source Discovery and Ingestion]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Working_Group_Process | Working Group Process]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Working_group_process | Working group process]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Working_groups | Working groups]] | ? | ? | ?| ? | ? |
# pages about non-public resources / infra
| wiki page | for who (visitor/user/contributor) | can be attached to another page? | category (1/2/3) | possible solution | maintenance frequency |
|------------|-----------------------------------------|----------------------------------------|----------------------|---------------------|-----------------------------|
|[[ https://wiki.softwareheritage.org/wiki/Ceph_Cluster | Ceph Cluster]] | sysadmin | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Dell_MD3460 | Dell MD3460]] | sysadmin | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Intranet | Intranet]] | ? | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Libvirt_Disk_Configuration | Libvirt Disk Configuration]] | sysadmin | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Puppet_setup | Puppet setup]] | sysadmin | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Streaming_Replication | Streaming Replication]] | sysadmin | ? | 4 (already moved)| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/New_machine_setup | New machine setup]] | sysadmin | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/VPN | VPN]] | contributor | ? | ?| ? | ? |
|[[ https://wiki.softwareheritage.org/wiki/Softwareheritage-ca.crt | Softwareheritage-ca.crt]] | contributor | ? | ?| ? | ? |
# internship pages
| wiki page | for who (visitor/user/contributor) | can be attached to another page? | category (1/2/3) | possible solution | maintenance frequency |
|------------|-----------------------------------------|----------------------------------------|----------------------|---------------------|-----------------------------|
| all internship pages | visitor (students) | no | 3 (ease of maintenance / status update) | nothing to do | as-need basis |