Conversation
kpengboy
left a comment
There was a problem hiding this comment.
Nice, this is a very welcome improvement. Thanks for working on it.
Some comments I have on the subdivision of documents:
- Perhaps it would be better to have a section to group the documents specifically for printing?
- There's also a blurry line between "Infrastructure" and "Maintenance" e.g. "Installing updates with apt-dater" is under Infrastructure while "lab-wakeup" is under Maintenance.
- Similarly, the division between User Services and Account Management is sometimes not clear - why are "Alumni account reset" and "approve" under User Services rather than Account Management?
|
Thanks for the feedback. I realize this patch has been sitting here for quite some time. However, this is kind of a good thing since I'm looking at the categories with a fresh set of eyes, and I agree that changes should be made. Putting printing in its own category seems like a good decision, since it certainly seems tangential to most of our other infrastructure. Infrastructure and Maintenance also look like they should be merged. I don't think I even remember what the difference was supposed to be for those. User Services and Account Management have a slightly better line between them: user services are procedures specific to a request a user might make, either over email or in person. Account management is for general tools used when dealing with accounts. I do plan to merge some articles here. If the number of articles in user services and account management are small enough, I would definitely consider merging those categories as well. |
|
Misclick sorry, I closed this and have no idea how to reopen it. |
|
fwiw, I am not sure if this will ever be merged. I would rather us use a static site generator for docs. |

This is the first phase of re-organizing staffdocs to be nicer to use. There are two big changes in this PR:
It looks like this:

Note that this PR is not being merged into the master branch-- instead I'm using a branch called staffdocs-redesign. I don't want to productionize this until the URLs stabilize. In a future PR, I plan to merge some pages (like sorry/unsorry) together.