// Comments in formulas

[Blaise_d_Estais]

Being able to // comment in formulas, like in normal code editors

[Ryan_Martens2]

Agreed that would be a nice feature. There are some workarounds, as mentioned in this thread:

Comment in formula

If you have a very pressing need to leave a note in a formula, there are ways of doing that. eg, you can replace some piece(of, code) with: SwitchIf SwitchIf("Here is my comment about this code", piece(of, code) ) WithName WithName("comment", Here is a more visible comment without quotes, piece(of, code) ) IfBlank (only if the value won’t be blank of course) piece(of, code).IfBlank("Here is my comment about this code") etc It’s not pretty, but it may be useful.

[Ed_Liveikis]

Would really love support for // comments in code also. Similarly, if a Rule could have a description. This way complicated docs will be easier to understand long in the future by the original author or more importantly, other people.

[steph]

Hi all, Coda has opened up a survey on feedback about commenting. If you’d like to participate, here’s the topic with the information:

Feedback requested: Coda is seeking feedback on commenting

Hey there! My name is Teresa and I’m a PM here at Coda. We’ve heard your feedback, and are now exploring ways to improve the commenting experience in Coda docs. At this point, we’re still in the research phase and can’t make any promises. With that in mind, we’d love to get some more contextual feedback from our awesome customers. If you’ve ever wished for comment improvements in Coda, if you use comments in other tools, or if you’re excited about comments in general, we’d love to get y…

[Guilherme_Salles]

As clarified in the comment section in the survey topic, unfortunatelly this feedback is focused on page commenting, which is a totally different thing from formula commenting.

[Agile_Dynamics]

what?

i thought this was for commenting FORMULAS

which is needed URGENTLY

i have no use for comments on pages
we already have a mechanism for that

???

max

[Guilherme_Salles]

I agree. I think the comment section is well developed and they shouldn’t be taking so much attention to that. They should definetly add formula commenting, which is a crucial thing for bigger workflows.

[l446240525]

Looks like Coda has an experimental support for /* comment */.

[Christiaan_Huizer]

@l446240525

/* comment */.

interesting, how did you find out?

[Martin_Portevin]

@l446240525

/* comment */

That would be huge news for me.

Unfortunately can’t reproduce it on my end

Maybe a test not deployed everywhere ?

[Agile_Dynamics]

alas, the OP example did not just fail on the // as indicated by the red markers.
thats probably due to the way the parser works, it didnt understand the /*111111*/ token and it didnt understand the // token either, but it only reports one error, not all the errors in the expression.

so; neither the //xxx// nor the /*xxx*/ are understood as comments

max

[Arpan_Laha]

Hi! I’m Arpan, a software engineer at Coda. I’m excited to share that you can now add comments to formulas! By enclosing parts of your formulas with /* and */, that portion will become a comment. To comment out an entire line, prefix the line with //.

Formula comments can help explain what’s going on in your most complicated formulas and can also be used to save prior versions of formulas you’d like to refer back to.

[Marc_Fitt]

@Arpan_Laha

ix the line with //.

Formula comments can help explain what’s going on in your most complicated formulas and can also be used to save prior versions of formulas you’d like to refer back to.

OMG FINALLLLLYYYY!!!

[Sebastien]

Hi Arpan,

thank you for such good news! It’s a pity to find it a bit hidden at the end of a thread — your post should totally be a new post in “News from Coda”, to make sure everyone in the community is aware of it!

[Ed_Liveikis]

Hi @Arpan_Laha, this easily deserves a News From Coda post! Super good.