Sto lavorando nel dominio del software incorporato e la mia area di lavoro principale è lo sviluppo del firmware per vari MCU.
Seguo la struttura delle cartelle come indicato di seguito per qualsiasi progetto firmware per rilasciare il codice sorgente e i documenti come bundle completo (archivio .zip) per l'utilizzo da parte del cliente.
XYZ-project-2.0.zip
|-> docs/
|-> XYZ-project-software-design-desciption-rev1.1.pdf
|-> XYZ-project-software-user-guide-rev1.3.pdf
|-> src/
|-> XYZ-project/
|-> src/
|-> test.c
|-> inc/
|-> test.h
Il codice sorgente contiene commenti Doxygen. e contiene il numero di versione 2.0 (uguale al file zip). Il cliente fa sempre riferimento a questa versione per qualsiasi discussione.
Quindi, ci sono due cose principali che possono essere modificate indipendentemente. Uno è il codice sorgente e l'altro è documenti.
incremento il numero di versione di XYZ-project-2.0.zip in XYZ-project-2.1.zip quando
- Se il codice sorgente è cambiato (aggiorno anche il numero di versione nei commenti doxygen da 2.0 a 2.1)
- Oppure qualsiasi versione del documento è stata modificata.
Il problema:
- Ogni volta che aggiorno un documento, cambio il numero di versione di quel documento (da XYZ-project-software-user-guide-rev1.3.pdf a XYZ-project-software-user-guide-rev1.4.pdf) e aggiornare il numero di versione del file zip (da XYZ-project-2.0.zip a XYZ-project-2.1.zip). ma devo anche aggiornare il numero di versione nel codice sorgente per mantenerlo uguale (commento della versione di ossigeno da 2.0 a 2.1).
Quindi, La mia domanda è,
- Esiste uno standard di settore per correlare la versione del software e la versione del documento. E come devo la versione finale del file zip?
- Dubito ancora di quale tag di versione dovrei aggiungere a qualsiasi documento. doc-Rev1.0.pdf? doc-v1.0.pdf? doc-Ap-A.pdf? C'è qualche standard?
Grazie.