docs: Running list of Eng / Design improvements for 2025

[dgmccart]

Engineering

• Custom examples of inherited functions Allow customized examples for common attributes/methods #890 and Include existing IDs in python API client docs for get_by_id #1381
• Autogeneration of data model
• Python scripts or notebooks generation for examples and tutorials
• Versioned docs
• Move Neuroglancer Quickstart to Tutorials Move Neuroglancer docs to tutorials section of docsite #1387
• Automate docsite deployment Automate docsite deployment #1388
• Implement Plausible web analytics tracking docs: Start tracking analytics using plausible #1453

Improving Design

• Improved API docs styling
• Accordion / admonition styling
• Fix functionality of copy link to highlight Friction when trying to link to a specific FAQ question #419
• Add anchor links to the doc site faq Add anchor links to the docsite FAQ questions #1386

[melissawm]

Effort estimation:

Engineering

• Custom examples of inherited functions (1h)
• Autogeneration of data model (on hold, waiting for eng suggestions)
• Python scripts or notebooks generation for examples and tutorials (10h)
• Versioned docs (10h)

Improving Design

• Improved API docs styling
  • I believe this is about the "attributes in table" issue. (10h)
• Accordion / admonition styling (5h)
• Add ability to link and copy link to specific questions in the doc site faq ( addressing Friction when trying to link to a specific FAQ question #419) - this may be an engineering issue, waiting on confirmation