: Our team needs to automate many routine tasks. Can we use a single tool or do we need to use multiple ones? Our tech comm team has a wide variety of time-consuming, repetitive tasks they

@Dunderdale623

Vote Up Vote Down

Our tech comm team has a wide variety of time-consuming, repetitive tasks they we need to automate. We are mainly using Sphinx, reStructuredText, Adobe Illustrator, and Visio.

Specific things we need to automate and make accessible via either a GUI or the command line are:

Creating reSructuredText files and their associated index entries in the :toctree: with a set of parameters that the author can specify that will be used to fill in fields such as the :ref: name, Title of the page, file name, index tags, and location of the page within the navigation hierarchy.
Moving sections of the documentation to a new position in the TOC.
Opening a Visio and/or Illustrator template and linking it appropriately in the .rst file with a specified directive, such as a figure or image with the correct width/height dimensions and caption.

We wish to keep the tooling to a minimum. It must be a solution that can be taught to the entire team who mostly don't have programming backgrounds, but are willing to learn.

Would a macro-type program such as Automator (we are using Macs) be most appropriate? Would we need to consider a programming language? Again, we would like to choose a single technology/tool, not multiple ones.

(1)

Login to post a comment!