Development PracticesDevelopment Practices
Tools-in-Action25min
BEGINNER

Backstage et TechDocs : vers une documentation vivante et utile

La documentation est un pilier essentiel, pourtant, elle finit trop souvent éparpillée, obsolète, voire ignorée. Et si produire, consulter et maintenir cette documentation devenait enfin naturel et intégré au quotidien des équipes ?
Dans ce talk, je vous propose d'explorer comment Backstage, le portail développeur open source de Spotify, réinvente notre rapport à la documentation grâce à TechDocs, son plugin "Docs as Code" intégré.
Nous verrons comment centraliser et standardiser efficacement la documentation technique, directement là où les développeurs travaillent et apprécient le faire : avec Git, la CI/CD et Markdown.

Youness REKASS
Youness REKASSOnepoint

talkDetail.whenAndWhere

Thursday, November 13, 11:30-11:55
Imlil
talks.roomOccupancytalks.noOccupancyInfo
talks.description
La documentation est un pilier essentiel, pourtant, elle finit trop souvent éparpillée, obsolète, voire ignorée. Et si produire, consulter et maintenir cette documentation devenait enfin naturel et intégré au quotidien des équipes ?
Dans ce talk, je vous propose d'explorer comment Backstage, le portail développeur open source de Spotify, réinvente notre rapport à la documentation grâce à TechDocs, son plugin "Docs as Code" intégré.
Nous verrons comment centraliser et standardiser efficacement la documentation technique, directement là où les développeurs travaillent et apprécient le faire : avec Git, la CI/CD et Markdown.
techdocs
git
backstage
documentation
talks.speakers
Youness REKASS

Youness REKASS

Onepoint

French Guiana

Développeur avec 9 ans d’expérience, je suis passionné par le monde du développement, le software craft et les bonnes pratiques. J’ai également un fort intérêt pour la documentation "as code", un domaine sur lequel j’ai contribué à plusieurs projets de mise en place. J’aime partager mes connaissances, échanger avec la communauté, et faire avancer les pratiques autour du code et de la documentation.

talkDetail.rateThisTalk

talkDetail.poortalkDetail.excellent

talkDetail.ratingNotYetAvailable

talkDetail.ratingAvailableWhenStarted

talkDetail.signInRequired

talkDetail.signInToRateDescription

occupancy.title

occupancy.votingNotYetAvailable

occupancy.votingAvailableBeforeStart

talkDetail.signInRequired

occupancy.signInToVoteDescription

comments.title

comments.speakerNotEnabledComments