Skip to content

Technical debt stand down Documentation

Freddie Akeroyd 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/Tom
  • 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

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.

Completed work

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.

Clone this wiki locally