search

getodk / docs

The documentation for all the ODK tools. This is one of the most popular artifacts our community produces. It's built in Sphinx. ✨📚✨
https://docs.getodk.org/
Other
53 stars 156 forks source link

update language about servers to reflect increasing maturity of Central #1221

Closed danbjoseph closed 4 years ago

danbjoseph commented 4 years ago

The Central docs open with

ODK Central is an ODK server alternative that is early in its development.

The most recent community update has

ODK Central: Ready for production use ODK Central, our replacement for ODK Aggregate, has been ready for production use for a few months!

I was wondering if the language in the docs should be adjusted? “Early in its development” might be interpreted more as ‘risky’ and less as ‘exciting and modern and fresh’? But was it already updated somewhat recently.. in my head I remembered it sounding more tentative/less confident about Central being ready to use. Upon re-reading it, I think it seems okay, but wanted to ask if anyone else thought it should sound closer to the vibe in the community announcement?

I posted the above in the ODK Slack and @lognaturel replied:

I agree that this would be good to revise. I don’t think “early in its development” is so accurate anymore, anyway! It would be great to revise some of the general docs to suggest Central first. Yet another thing to do!

danbjoseph commented 4 years ago

wohoo! inspiring work @lognaturel, @issa-tseng, @matthew-white, @yanokwa, and all!