studio-api-docs

What is it?

This the main repository for the Trados Studio Public API documentation.

Can I contribute?

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

The documentation is split into the following sections:

• Articles
  • This section hosts a series of usefull article on:
    • how to get started with writing plug-ins for Trados Studio
    • how to best use the public APIs
    • how to troubleshoot common issues
• API Concepts
  • This section hosts the main guidelines on using the Public API along with the API References

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 Trados Studio
  <var:ProductNameWithEdition> - The official product release name including the edition, for example 'Trados Studio 2021'
  <var:ProductVersion> - the official product version, for example Studio16
  <var:VersionNumber> - the official product version number, such as 16
  <var:VisualStudioEdition> - the most recent development compatible Microsoft Visual Studio edition
  <var:PluginPackedPath> - the location where plugins are deployed, for example '%AppData%\Roaming\SDL\SDL Trados Studio\16\Plugins\Packages\'
  <var:PluginUnpackedPath> - the location where plugins are unpacked, for example '%AppData%\Roaming\SDL\SDL Trados Studio\16\Plugins\Unpacked\'
  <var:InstallationFolder> - the current installation folder of our product, for example 'C:\Program Files\SDL\SDL Trados Studio\Studio16\'
  

Writing guidelines

For consistency and ease of use we recommend you read Writing Guidelines before making any contribution. This helps keep a consistency across the reading material as well facilitate good writing and straightforward expression of concepts.