Tutti i documenti sono un po 'diversi, ma direi di posizionarli in documenti separati. Dico questo perché iOS e Android piattaforme diverse con caratteristiche diverse. Tutto dipende dal tuo ambito ma l'ambito di un progetto può cambiare in qualsiasi momento. Mi sento come se fosse un po 'un casino.
Supponiamo che le modifiche apportate all'ambito di Android Dev e per qualche motivo ora ti servano l'accesso al fornitore di contenuti del contatto telefonico o forse l'aggiunta di un widget? Tu fai il cambiamento e spedisci il documento a tutti i Devs. Se io sono un Dev iOS, perché c'è una documentazione aggiornata che mi dice che ho bisogno di accedere al fornitore di contenuti del contatto telefonico (che è qualcosa di molto specifico per Android)? O forse devi modificare un pezzo del tuo documento perché l'app store iOS ha negato una delle tue pratiche di sviluppo. La stessa cosa si applica ed è un po 'di confusione. Per non parlare del fatto che se si tenta di evitarlo e decidere di apportare modifiche in un'unica piattaforma e aggiornare solo quegli sviluppatori dei propri cambiamenti, la documentazione è incoerente e può portare ad altri problemi.
Supporrei che tu abbia due squadre separate? Stanno scrivendo in due lingue diverse per diversi negozi di applicazioni mobili con le proprie regole e regolamenti. Sarebbe più semplice e facile da gestire se entrambi avessero la propria documentazione.