Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

wiki cleanup #1882

Open
pkra opened this issue Mar 9, 2023 · 7 comments · Fixed by #1886 · May be fixed by #2338
Open

wiki cleanup #1882

pkra opened this issue Mar 9, 2023 · 7 comments · Fixed by #1886 · May be fixed by #2338
Assignees
@pkra
Labels
Agenda-Editors editorial a change to an example, note, spelling, grammar, or is related to publishing or the repo
Milestone
2023

Comments

@pkra
Copy link
Member

pkra commented Mar 9, 2023

As discussed at the editors meeting, the wiki is not in great shape. Most articles appear out of date. Very few have seen a significant update in the past year.

We should decide which pages we want to maintain and which alternative means we have to maintain them. We should also decide how to archive what we don't want to maintain.
@pkra pkra added the editorial a change to an example, note, spelling, grammar, or is related to publishing or the repo label Mar 9, 2023
@pkra pkra self-assigned this Mar 9, 2023
@pkra
Copy link
Member Author

pkra commented Mar 9, 2023

Some examples

@pkra
Copy link
Member Author

pkra commented Mar 9, 2023 •
edited
Loading

My impression is, the group has successfully used the wiki for temporary documents, i.e., drafts that led to spec changes.

If that's consensus, then perhaps the wiki should be focused on that, in which case the permanent content should move elsewhere (e.g., into the main repository) and old wiki pages can be deleted. In that case, we should check that the wiki works in terms of archival requirements; it's a git repository, so ideally nothing gets removed from the git history.

@pkra pkra mentioned this issue Mar 21, 2023
Merged
pkra pushed a commit that referenced this issue Mar 21, 2023
@spectranaut
Editorial: move wiki documents to document folder (#1886)
9033f63 
Partially resolves #1882
@pkra
Copy link
Member Author

pkra commented Mar 21, 2023 •
edited
Loading

Accidental close - #1886 only partially resolves this.

@pkra pkra reopened this Mar 21, 2023
@pkra
Copy link
Member Author

pkra commented Apr 20, 2023

In that case, we should check that the wiki works in terms of archival requirements; it's a git repository, so ideally nothing gets removed from the git history.

I just checked that the wiki works as you'd expect of any git repository -- deleted pages are just a regular commit (i.e. no purging) so they can be easily recovered if need be.

@YummyBacon5 YummyBacon5 mentioned this issue Jun 15, 2023
Closed
@pkra
Copy link
Member Author

pkra commented Jun 28, 2023

I've removed several pages that were obviously temporary or abandoned. I also updated the sidebar.

The next step would be to move notable pages into the repository's doc folder. I will start with just the final versions since we will still have the history in the wiki's git repository after removing the page if anyone needs it.

@pkra pkra added this to the ARIA 1.3 milestone Jun 28, 2023
jnurthen pushed a commit that referenced this issue Oct 10, 2023
@spectranaut @jnurthen
Editorial: move wiki documents to document folder (#1886)
435f02d 
Partially resolves #1882
@pkra
Copy link
Member Author

pkra commented Sep 19, 2024 •
edited
Loading

Following up on the editors' meeting. Here's the current set of (non-home-) pages with date of last edit and a first suggestion what to do with them

  • [last edit: Apr 1, 2021] 1.2 Non editorial features and other changes => 1.2 archive
  • [last edit: Jan 10, 2019] ARIA annotations draft proposal => 1.2 archive
  • [last edit: Feb 26, 2018] CSS AAM Potential Features => maybe for HTML-AAM's renewed effort? maybe archive "unresolved"
  • [last edit: May 23, 2019] Generic Role End to End => 1.2 archive
  • [last edit: May 21, 2024] Monorepo Project => group process archive
  • [last edit: Jul 29, 2022] Non modal dialog use cases => delete?
  • [last edit: Oct 17, 2019] On the ARIA DPUB impasse listing of the options => dpub-aria archive
  • [last edit: Jan 24, 2022] Plans regarding attribute parity => archive "unresolved"
  • [last edit: Apr 1, 2022] Plans regarding role parity => archive for 1.2 or unresolved?
  • [last edit: Oct 18, 2023] Proposal: Interactive Lists => 1.3 archive (too soon?)
  • [last edit: Sep 28, 2018] Required Properties with Default Values => 1.2 archive
  • [last edit: Jul 20, 2023 / Oct 18, 2019] Resolving ARIA 1.1 Combobox Issues => 1.2 archive
  • [last edit: May 3, 2023] Spring 2023 F2F => group process archive
  • [last edit: May 8, 2020] Testing aria hidden => archive "test"?
  • [last edit: Dec 5, 2018] Text Separation attribute proposals => archive "unresolved"?
  • [last edit: Sep 14, 2023] TPAC 2023 ARIA Meetings => group process archive
  • [active] TPAC 2024 ARIA Meetings => group process archive (after tpac)

pkra added a commit that referenced this issue Sep 19, 2024
@pkra
editorial: archive for wiki page "1.2 Non editorial features and othe…
1245612 
…r changes"

Adds editorial note; removes toc commands for markdown conversion.

Part of #1882
pkra added a commit that referenced this issue Sep 19, 2024
@pkra
editorial: archive for wiki page "ARIA annotations draft proposal"
07d95af 
Adds editorial note.

Part of #1882
pkra added a commit that referenced this issue Sep 19, 2024
@pkra
editorial: archive for wiki page "Generic Role End to End "
afea532 
Adds editorial note.

Part of #1882
pkra added a commit that referenced this issue Sep 19, 2024
@pkra
editorial: archive for wiki page "Plans regarding role parity"
eadf6b5 
Adds editorial note; removes toc commands for markdown conversion.

Part of #1882
pkra added a commit that referenced this issue Sep 19, 2024
@pkra
editorial: archive for wiki page "Required Properties with Default Va…
66895e2 
…lues"

Adds editorial note.

Part of #1882
pkra added a commit that referenced this issue Sep 19, 2024
@pkra
editorial: archive for wiki page "Resolving ARIA 1.1 Combobox Issues"
5da046a 
Adds editorial note.

Part of #1882
pkra added a commit that referenced this issue Sep 19, 2024
@pkra
editorial: archive for wiki page "Monorepo Project"
8e32a7a 
Adds editorial note.

Part of #1882
pkra added a commit that referenced this issue Sep 19, 2024
@pkra
editorial: archive for wiki page "Spring 2023 F2F"
936c76f 
Adds editorial note.

Part of #1882
pkra added a commit that referenced this issue Sep 19, 2024
@pkra
editorial: archive for wiki page "TPAC 2023 ARIA Meetings"
721d769 
Adds editorial note.

Part of #1882
@pkra pkra linked a pull request Sep 19, 2024 that will close this issue
Draft
17 tasks
@pkra
Copy link
Member Author

pkra commented Sep 19, 2024

=> #2338

pkra added a commit that referenced this issue Sep 19, 2024
@pkra
editorial: archive for wiki page "Text Separation attribute proposals"
db4ab75 
Adds editorial note.

Part of #1882
pkra added a commit that referenced this issue Sep 19, 2024
@pkra
editorial: archive for wiki page "Plans regarding attribute parity"
385cdac 
Adds editorial note. Drops asciidoc toc macros.

Part of #1882
pkra added a commit that referenced this issue Sep 19, 2024
@pkra
editorial: archive for wiki page "On the ARIA DPUB impasse listing of…
b14d824 
… the options"

Adds editorial note.

Part of #1882
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees

@pkra pkra

Labels
Agenda-Editors editorial a change to an example, note, spelling, grammar, or is related to publishing or the repo
Projects
None yet
Milestone
2023
Development

Successfully merging a pull request may close this issue.

Editorial: move wiki documents to document folder w3c/aria
editorial: wiki archiving w3c/aria
1 participant
@pkra