GoogleCloudPlatform / GoogleCloudPlatform/knowledge-catalog

Support .org (emacs org mode) and .adoc (asciidoc)

Open
#67 1 comment 3 reactions 0 assignees View on GitHub
Dominant language
TypeScript
Stars
9.2k
Forks
782
Avg merge
6h 36m
Merged PRs (30d)
85

Description

Markdown is obviously the popular format of the moment for AI consumption and generation, but is fundamentally flawed in terms of richness.

We as humans can't keep up with the amount of textual data being generated by AI, but at least a richer format (in particular more visual formats) could help us generate docs that are more expressive, more visual, and therefore a document with a strong mix of text AND visuals could help us 'keep up'.

So with that said, we should add support for .adoc and .org.

Two options immediately come to mind:
* We could down-convert each to markdown as they get consumed.
* We could instead consume them without conversion.
* I'd vote this way because the point of these would be the richness they offer, losing that richness in the index is ultimately hamstringing the possibilities of future features that are based off of the index.

I'm keen to add this support, would take any suggestions on the path forward, hot takes, etc.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.