I remember from my long-gone days as a developer that great code documentation is vital for long-term projects. Cue a couple of head-scratching moments when re-opening earlier Coda docs… So I started writing comments in the doc itself, e.g. =if([toggle implementation notes],"A helpful comment on wh…

I used a hidden page inside document to “explain” all the relations, formulas, workflows etc, but there are for sure more efficient ways to do it :slight_smile: Also formula comments would be such a nice addition, with the complexity you can achieve in Coda I start to think they are must

i once had a client who wanted me to provide descriptions for every column in every table in the doc we built them. so i created a page for each table with a detail-view for that table. in the edit-layout for that view, i provided a description in the extended-label field for each column. that wa…

That is clever! My dream for table documentation is a text box built right into the column options dropdown. Currently, I do a “Source Tables” section with a table per page, and include a description and a bulleted list right in the canvas about the table, but it’s a pain and there’s no way for it t…

3 tricks: a :arrow_forward: dropdown [>>] with a “:information_source:” / “info” / “readme”, to say people should read here for documentation/explanations. It would be nice if it could be default open or some kind of callout, especially for first time coda users, who see the doc as an app, and who …

Makers, how do you document your docs?

Fran_Vidicek September 30, 2022, 9:57am 3

Comments in formula editor +1
Vote here if you haven’t already: // Comments in formulas

Topic		Replies	Views
Feedback requested: Coda is seeking feedback on commenting	12	3231	May 5, 2022
Ability to make comments in formulas Product Feedback	22	1715	February 28, 2023
Annotate formulas and columns Product Feedback	1	615	May 20, 2022
Let's Mock Excel a Bit	12	2963	April 14, 2021
// Comments in formulas Product Feedback	14	2278	February 24, 2023

Makers, how do you document your docs?

Related topics