Hi guys

A lot of design docs are done through gdoc. I see how awesome it is to work
but @asf it has a few issues - and more bothering, it quickly makes the
tracking blurry.

Out of my head here are a few issues I see/hit:

- it doesnt happen on the list (even if a mail is sent the content is not
available) -  makes the search kind of harder
- it is not under asf umbrella I think (is there an asf account or so under
pmc scope which can track all actions?)
- versionning is hard to follow or it is not versionned at all
- it is "somewhere" but very hard to find with common tools (list archives,
main git, ...)

Therefore I propose to use gdoc for short period of time if you feel it
better and just integrate designs as sources as well (in asciidoctor to
have diagrams and all potential syntax or directly the site source but
inline/not link?). This will fix all but the first issue and even allow to
comment on PRs/reviews instead of gdoc.

For the first point we can do as for incubator projects and include the
original content in text form at the end of the mail. Will give enough
context to find the thread back hopefully.

Wdyt? Anyone else hitting these issues from time to time?

Reply via email to