Sono il fondatore di un sito web chiamato Now.in. All'inizio ho scritto tutti i programmi da solo. E gestiremo una start-up. Altre persone saranno presto coinvolte. Nella mia mente esistono solo alcuni know-how / panoramiche, ci vuole del tempo per spiegare ai nuovi arrivati. Quindi, vorrei scrivere alcuni documenti che altri possano leggere. Ecco il problema, come scrivere documenti? Quale strumento / piattaforma dovrei usare?
Ho qualche dubbio.
Portabilità
Di sicuro posso solo scrivere documenti in Google Docs, eseguire un Wiki, o anche usare wiki del repository BitBucket direttamente. Ma il problema è, cosa succede se mi piacerebbe utilizzare un altro sistema di documenti piuttosto che quello attuale? Sarebbe difficile e costoso convertire documenti tra lingue di markdown / Google Documenti.
Facile da usare
I diagrammi sono importanti nei documenti per spiegare le cose. Alcuni dei semplici sistemi wiki / doc non supportano il caricamento di immagini. Puoi caricare l'immagine da qualche altra parte e inserire il tag immagine nei documenti, il che è piuttosto scomodo da usare.
Inoltre, sembra che alcuni di questi linguaggi di markdown siano difficili da imparare e ricordare. Non mi piace passare un mese per imparare qualcosa che assomiglia a LaTeX e iniziare a scrivere un documento, che mi farà impazzire. Markdown semplice ed espressivo / WYSIWYG sarebbe bello.
Espressione di codice
Google Doc è facile da usare e abbastanza potente. Tuttavia, a volte vorrei scrivere esempi di codice nei documenti. È bene avere l'evidenziazione della sintassi. Ma Google Doc non è facile da usare per la scrittura del codice.
Essendo un codice amichevole, sarebbe anche una bella funzionalità.
Integrazione con documenti API
Per documenti di panoramica / SOP / Know-how, è bene scriverli direttamente nel sistema di documenti. Ma per la mia base di codice Python, potrebbero esserci alcuni documenti generati a livello API da quei codici. Sarebbe scomodo avere due sistemi di documenti, uno per l'API e uno per le panoramiche. Quindi, penso che sarebbe bello averli integrati insieme.
Quindi .... Che cosa usare?
Forse ho qualche dubbio in più nella mia mente, ma non riesco a ricordarli in questo momento. Mi piacerebbe sapere che tipo di sistema di documenti stai usando? Potresti raccomandarne qualcuno? Va bene anche se ci vuole un po 'di soldi per usare la piattaforma / sistema, possiamo permetterci se non è troppo costoso.