Skip to content

Bilara projects and publishing workflow

carmi cronje (she/her) edited this page Jun 18, 2022 · 1 revision

The following defines the process of making and publishing a translation on Bilara.

Step Description Who is responsible
0 The translator discusses their project with Bhante Sujato and reviews the Guide for translators. Translator
1 The translator is given write access to the bilara-data GitHub repository. This allows the Bilara translation app to communicate with GitHub's workflows, which maintain version control of texts and their publication to SuttaCentral. Publications manager
2 The translator's project is created in _project.json (and _project-v2.json) and publication details added to _publication.json (and _publication-v2.json). The author is added to _author.json. This creates the project in Bilara, and will provide attribution for the author's translations on SuttaCentral once published. See the master spreadsheet for Bilara projects and publication metadata for reference. All updates to admin files are done in both the unpublished and published branches in bilara-data. Publications manager
3 The translator logs into Bilara, navigates to their project (indicated by the bolded folder name) and begins translating. Translator
4 When the translator selects enter or return on a segment of text, a green tick appears, indicating the translation has been saved and automatically pushed to the unpublished branch for safe keeping. From this point, a PUBLISH button will appear in Bilara. Translator
5 It is recommended translators request peer review of their translations. The SuttaCentral community can assist. Translator
6 Once a translator is satisfied with their final translation, they select PUBLISH in Bilara to trigger publication steps. Translator
7 A pull request is created in the bilara-data repository, which is reviewed and merged into the published branch. Publications manager
8 The translation is then published on Suttacentral and can be utilised by other software/web apps - and humans! 🎉🎉🎉
9 Translators retain access to their projects. If a translator wishes to revise a published translation they can. When they do, an UPDATE button will appear in Bilara, and steps 5-8 are repeated (in this case UPDATE performs the same function as PUBLISH). Translator