Make backticks et al. consistent in the abstract spec

[johnkerl]

Context: #120

Basic copy-editing:

• Make use of backticking consistent -- it was mixed on/off even in the same sentence
• Uniformize -, --, and : to :
• Uniformize periods at ends of sentences
• Correctly spell i.e. and e.g.
• Etc.

Reviewer-friendly rendering: https://github.com/single-cell-data/SOMA/blob/kerl/backticks-et-al/abstract_specification.md

[johnkerl]

@thetorpedodog @bkmartinjr ping 🙏

[johnkerl]

@bkmartinjr on my commits after your feedback I ran prettier abstract_specification.md and, as noted, reverted * bullets to - bullets.

[bkmartinjr]

@johnkerl - lets codify the formatting conventions (i.e., we use "tool X" with "Y config" somewhere).

[johnkerl]

@bkmartinjr thanks!

What does "codify" mean to you in terms of an actionable step?

• I update the wiki for this repo asking people to use it
• I update the pre-commit logic for this repo (automating it)
• Or something else?

[bkmartinjr]

What does "codify" mean to you in terms of an actionable step?

Ideally we should have a CI check it. But that is nice-to-have. I'd settle for "write it down in a conventions doc" for now, and we can CI stuff like this at a later date.

[johnkerl]

Ideally we should have a CI check it. But that is nice-to-have. I'd settle for "write it down in a conventions doc" for now, and we can CI stuff like this at a later date.

• https://github.com/single-cell-data/SOMA/wiki has been updated for the short term
• https://github.com/single-cell-data/SOMA/issues/132 has been created to track for the long term