Closed NeilMcKLogic closed 7 years ago
Great point. I wonder if it would be better to remove the link to the Google Doc and just keep the Markdown-formatted spec that's in this repo. That way, whoever is maintaining the spec doesn't have to worry about keeping multiple versions in sync.
Your call. I just think the DRAFT would be off- putting to someone new to Open Referral. I am not new and was wondering if I was looking at the right version, since I knew it had been finalized.
re: moving the spec from Google Docs to Github-only, I think that's probably something we should do. However I haven't figured out the right setup yet; will open another issue.
I'd recommend continuing to maintain a Google Docs version so that people can comment on specific parts of it using a familiar system. I doubt many practitioners engaged in human services work will want to register and learn Github to make comments.
In the Google Doc I'd say "For the most up to date stable draft of the technical specification, go to the Github spec."
I don't think you need to point people from the Github to the Google Doc. If they're already familiar with Github it's best to keep them interacting there.
On Wed, Apr 20, 2016 at 9:12 AM, Greg Bloom notifications@github.com wrote:
re: moving the spec from Google Docs to Github-only, I think that's probably something we should do. However I haven't figured out the right setup yet; will open another issue.
— You are receiving this because you are subscribed to this thread. Reply to this email directly or view it on GitHub https://github.com/codeforamerica/OpenReferral/issues/94#issuecomment-212418296
@devinbalkind see issue #96
Thanks but I read that already and deliberately posted the comment on this thread.
On Wed, Apr 20, 2016 at 11:32 AM, Greg Bloom notifications@github.com wrote:
@devinbalkind https://github.com/devinbalkind see issue #96 https://github.com/codeforamerica/OpenReferral/issues/96
— You are receiving this because you were mentioned. Reply to this email directly or view it on GitHub https://github.com/codeforamerica/OpenReferral/issues/94#issuecomment-212479228
The docs at http://docs.openreferral.org/en/latest/reference/ include hypothes.is to allow for user-friendly comments without people needing to get into the GitHubs.
I'll add documentation of how this can be used to the next version of the docs.
@greggish Can you update the google doc to indicate that it is now deprecated and people should work from the docs website?
Once that is done, safe to close this issue.
Done!
I may still have to find other mentions of the old Github / Docs URL in other documentation, but in the meantime, the HSDS v1.0 Google Doc is deprecated via the header and redirects to docs.openreferral.org
There is still a watermark of DRAFT even though the spec was approved a long time ago.
https://docs.google.com/document/d/1dkipRm_YL3K28oTSG-NFZRMHYiv10ZZJzJlakZglOyc/edit?pref=2&pli=1