RWS-Developers

What is it?

This the main repository for the RWS Developers documentation.

Can I contribute?

Anyone is welcome to contribute to the public documentation by making a pull request into the master repository.

Getting started with your contribution

The documentation is built using a static documentation generator called DocFX. The documentation content is saved in Markdown files and then built into a website using DocFX. The table of content is saved into separate toc.yml files.

In order for you to make a contribution directly please follow the next steps:

• Create a local branch from the main repository

• Add your changes by modifying existing Markdown files or by adding new Markdown files

  • Adding new files will require updating the toc.yml files. Use the guideline provided by DocFX to learn more.
  • You can use tools such as Notepad++ or Visual Studio Code to edit the content

• Create a Pull Request with your changes.

  • This pull request will be reviewed for correctness by one of our technical writers

• Once your pull request has been approved and committed into the main branch, an automatic pipeline will be triggered which will push your changes to the live documentation site

• if you wish to test your changes locally you can follow the DOCFX Installation guideline and build the entire solution locally

• Our documentation automatically fills in the product name and other details so you don't have to make the changes manually if we decide to update the product name. Use the 'var:VariableName' construct to tell our documentation engine to fill in the info for you. Here are the constructs available at this point:

  var:ProductName - The product name, for example RWS Developers