Skip to content

Technical debt stand down Documentation

Tom Willemsen edited this page Feb 2, 2018 · 18 revisions

This page describes the work done as part of the documentation stand down on 2nd February 2018.

Work in progress

IOC creation tidy up

  • Developer: Dom
  • Reviewer: None
  • Current status: In progress

The IOC pages are messy, I will tidy them up

Create a spell checking utility for the wikis

  • Developer: Adrian
  • Reviewer: None
  • Current status: In progress

As a developer, I would like the wiki to be spell checked so that I can be confident in the high quality of language use in the documentation.

I'm writing this as a general purpose unit test framework for the wikis so that we can add additional tests later on.

Major components Page Completion

  • Developer: John
  • Reviewer: None
  • Current status: In progress

Complete the page Major-Components-of-Ibex-Server.

Pages affected

  • None directly

Acceptance criteria

  • Spell checker provides a test report for mis-spelled words in the wiki, along with their location
  • There are no false positives reported by the spell checker. Common project specific words will be ignored
  • The test can be run on individual files or the whole wiki
  • The spell checker supports RST and markdown format (i.e. can be used on developer and user manual)

Updating Glossary in User Manual

  • Developer: Aidan
  • Reviewer: None
  • Current status: In progress

As a user I would like a more complete glossary for terms I may not have come across before.

Pages affected

Moving between SECI and IBEX user manual page

  • Developer: Freddie
  • Reviewer: None
  • Current status: In progress

As an instrument scientist I would like to know how to move between SECI and IBEX

Ready for review

Move work in progress here when it's ready for review.

Updating info for new starters

  • Developer: Eilidh
  • Reviewer: Tom
  • Current status: Ready for review: Page Link . Linked from Dev Manual under 'New Starters'.

As a new member of the IBEX team, I'd like accessible and comprehensive info on getting started with EPICS/IBEX.

Completed work

Move reviewed work here once complete.

Clone this wiki locally