Documentation Improvement - use indents

[Jegelewicz]

From an incoming collection who was asked to follow the instructions in How To Manage a Collection

The only other (nitpicky) thing I might suggest is whether it's possible to indent the sections? I know that "How to Manage a Collection", "Arctos Community Data", and "GUID Prefix", for instance, are all at different font size, but it might be easier for folks to follow along if "GUID Prefix", "Collection Type", etc. were indented below "Arctos Community Data". However, this is also a style choice for all the Arctos wikis/handbooks, so maybe not something you want to mess with. And as I say, this is just a change that would help people like me who are too lazy to read all the detail and just skim things and then miss sections--people should really just read the whole document and follow along!

My response

Thanks for the feedback!

I hear you on the indents. I have thought about this and there are a few places where someone has tried to do it, but markdown doesn't really support it and that means it requires knowledge of css and html - which can be a barrier if we want everyone to be able to edit the handbook (not that everyone does - but we are ever-hopeful....)

The section headers are headers though, and on the left side of the page you can see a kind of index that expands as you move through the documents. These headers are indented - but I'm not sure that people notice or pay attention to that side panel.

Long documents are definitely difficult to read and the headers are difficult to distinguish between #, ##, and ###.

Can we add indentations in some way that makes it easy for inexperienced editors to manage?