{"repo":"betagouv/sillon","free":true,"listed":false,"github":"https://github.com/betagouv/sillon","clone":"git clone https://github.com/betagouv/sillon.git","description":"A knowledge base and recommendations in the choices of implementation of a digital product within a French administration (but not only)","language":"TypeScript","stars":14,"topics":["cicd","devops","dsfr","figma","french","guidelines","javascript","nextjs","nodejs","postgresql"],"license":"MIT","category":"deployment-docker-iac","readme_excerpt":"sillon This project can serve as a knowledge base and a guide in making decisions for the implementation of a digital product within a French administration (and beyond). It is neither sponsored by an administration nor by a beta.gouv incubator. It is currently an initiative aimed at addressing a perceived gap. Only the technical part of Sillon is in English, while the rest is in French to facilitate adoption by the initial target audience. If you are looking for an English version, an automated translation through a plugin should generate something comprehensible. How it has been written To facilite the collaboration on the first version we used a collaborative \".docx\" and once we considered it as a first acceptable version we had to convert it to the Markdown format to be compatible with Docusaurus. For this we used pandoc and then we just splitted the result across multiple files depending on our document sections. Since then we rely on direct text contributions but keep in mind this process can be reuse in case you write multiple big sections. The command: Then a few hacks to apply in the .mdx output: - Give a size to images to avoid large ones - Replace code sections with appropriate Docusaurus blocks - Replace information sections with appropriate Docusaurus blocks - Split the single output file into multiple ones and manage their sidebar position - Adjust the sidebars.js file so the sidebar menu matches splitted files - Move images next to the files they are displayed ","default_branch":null,"files":null,"tree":[],"storefront":"/r/betagouv","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/betagouv/sillon/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}