Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Development process content feels in need of a refresh #211

Closed
46bit opened this issue May 15, 2018 · 4 comments
Closed

Development process content feels in need of a refresh #211

46bit opened this issue May 15, 2018 · 4 comments

Comments

@46bit
Copy link
Contributor

46bit commented May 15, 2018

https://team-manual.cloud.service.gov.uk/team/working_practices/ starts by showing our Development Process, but it's hard to make changes to this content and it isn't very in-line with the Doing--Reviewing--Approving model that Rubbernecker/PivotalTracker create.

@46bit 46bit changed the title The development process diagram is pretty but is Development process content feels in need of a refresh May 15, 2018
@bleach
Copy link
Contributor

bleach commented May 15, 2018

I looked back on #26 and there wasn't enough clarifying context. So here's some:

This is explicitly supposed to describe the doing-reviewing-approving process. It looks like some of the text within the diagrams describing which roles do what is outdated.

This came about because we were asked by the Information Assurance team for some documentation on development process showing how changes got into production. I thought this would be useful to have written down and I didn't want to bury this in an IA document that the team don't refer to very often, so I put it here and added a link from the IA document.

At the time there wasn't anything that I could get to work with mkdocs that would produce diagrams from source, so we ended up with the need to install blockdiag and run make. There are middleman extensions for diagrams that could be tried.

@46bit
Copy link
Contributor Author

46bit commented May 15, 2018

Thanks @bleach! The diagrams and description are quite effective from an IA point of view, but I've found less so from other contexts (e.g., a new team member trying to understand what they should do.)

I'm moving off of the PaaS tomorrow 😢 and these issues are something of a dump of ideas in my head.

@alext
Copy link
Contributor

alext commented Jul 6, 2018

@46bit Do you think #230 has addressed these comments, or does it still need further updating?

@46bit
Copy link
Contributor Author

46bit commented May 7, 2019

We've addressed this well.

@46bit 46bit closed this as completed May 7, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants