Closed harisood closed 1 year ago
Things to consider:
I think the last option, a form which people can fill in, and reference which part of the doc they want to comment on (e.g. as a list of checkboxes, plus other
), is easiest. However I'm happy to support something more complicated if people are willing to do the work to implement and run it.
@arronlacey and I agreed to give GD a go and sync it once a week, he's in the process of setting it up now!
I have created an MS Form mock-up for this https://dmail.sharepoint.com/:w:/r/sites/SATRE/_layouts/15/Doc.aspx?sourcedoc=%7BBDC4E02A-B599-471A-AE7F-1B1FD712239F%7D&file=SATRE%20Specification%20Edits%20Form.docx&action=default&mobileredirect=true
@manics what do you think? would you be able to draft up the final form?
^^ I can't think of a satisfactory way to do this with GD without a lot of continuous manual work to keep on top of it so I am backing MS Forms for this.
@arronlacey yes, I'll update the demo MSForm that autocreates a GitHub issue when I'm back in the office, and share it for review/testing
Thanks Simon!
looks great @manics !
Let's inform everyone at the next Collab Cafe and maybe put a link into the specification itself?
Looks good! Can we explicitly mention email too in the last one, so we can e.g. get in touch with people to discuss further if we need clarification? Maybe even a different question?
I think we could also make it clearer that conversation will be happening on GitHub, so it would be absolutely great to get their GH username (or for them to create one using the walkthrough) so we can alert them to developments in the convo
I think this form is the last resort- if there's a chance people are willing to use GitHub they should be encouraged to go that way and ideally should never even see this form in the first place. We could add email, but we need a way to keep track of it as information will end up in two places- the content of the issue which gets added to the public repo, and the private issue.
Agreed - though feel email would be good just in case a bit of clarification/key follow up question is needed
I've updated the form and the GH issue integration, what do you think?
I've also added some docs on the workflow to https://github.com/sa-tre/satre-specification-private
Sounds good! Is that workflow detailed enough?
Summary of issue
In order to make contribution as seamless as possible for a range of stakeholders with diverse skillsets, we are going to create a version of the specification that lives on Google Docs (GD), rather than just GitHub (GH). The process will be:
What needs to be done?
Who can help?
Issue checklist
SATRE backlog (public)
project board