[WIP] Add project management documentation #69

malteserteresa · 2020-04-08T07:33:18Z

This can be found in the PROJECT_MANAGEMENT.md file

TODO

Add dev - designer - user flow suggestions
Add feature request -> requirements flow suggestion

djbusstop · 2020-04-08T07:41:51Z

I wrote some PM things I learned, and how I'm doing stuff for web extension. These don't need to go in the docs exactly as written. But could help the docs. I don't know what the best way to organise these things or how specific we want to be.

Types of open meeting:

Sprint planning - In first week after a release, to get people to take ownership for tasks for the next sprint, and see what needs more info for people to do it
Check In - Like a stand up but biweekly. To make sure tasks assigned at sprint planning are moving smoothly
Planning - Where we talk about bigger issues that require people across multiple teams. We break these in to smaller tasks and see what depends on what in order to get the task ready to be developed when it's time for it to go in the sprint.

Workflow for normal sprint:

Create issues on github (as a result of a planning meeting, or they are created at any time)
Manage the issue meta data and information as much as possible before the issue is ready to be handled in this current sprint. (This is done in a sprint planning or planning meeting)
Put the issue in the github project board when it's in the current sprint (this can be seen by the milestone on the issue)
Make sure in check in meetings that these issues are progressing
When the sprint changes, clean up the workspace
Have a sprint planning meeting to decide what goes in workspace again 🙂

Product management lessons:

Have meetings mid sprint to talk about issues for the next sprint. This helps stay ahead when it comes to specs, that they are ready when it's time to start working.
Remind people about meetings
Host a retrospective to reflect with others on how this system is working.
Someone needs to take ownership of a board. Probably the same person hosting the meeting to make sure tasks are progressing. But without ownership, the board gets outdated and just is cluttered.

djbusstop · 2020-04-10T09:21:46Z

CONTRIBUTING.md

+Bug: a problem with the code that needs fixing
+Feature request: an idea for new features
+Feature implementation: details and suggested steps to be completed to add the feature/fix the bug
+Bug and feature requests become feature implementations when someone has a brainwave of how to complete the task. Thus a feature implementation issue may contain clear instructions of how to complete task.


I don't know if a bug necessarily becomes a feature implementation. I think it's fine to leave an issue as "bug". Cuz fixing bugs isn't implementing a feature. So I guess I would just change this by removing the words "Bug and-" from the begnning of this sentence.

Agreed. Bug fix and feature implementations are two different things. Also this type of info is specific to each repo so I deleted it from the CONTRIBUTING file.

djbusstop · 2020-04-10T09:24:34Z

CONTRIBUTING.md

-review
-
+[WIP]: indicate you are working on something to avoid duplicated work, request broad review of functionality or API, or seek collaborators (use the help wanted label).
+[MRG]: the contribution is complete and should be subjected to a detailed review. If the work is in this state, it should reference the feature request/bug it is fixing


I have never seen this before? I am used to having WIP removed as the indication of status. In the browser extension board there is a lane for review. I would use this as the best place to show the status.

This is the workflow for the data team actually, see "Working on a modeling issue" section here. I think we shouldn't generalize the practices of one team to all teams. Also I deleted this info from the CONTRIBUTING file as this is very specific to the people who want to contribute code and this repo should contain information on how to contribute to the project generally. Let me know if the new CONTRIBUTING file covers all cases.

djbusstop · 2020-04-10T09:26:19Z

ORG_STRUCTURE.md

+- Matteo Guzzo
+
+#### Engineering & DevOps
+- River Honer


Eep um I would much prefer a link to my github than just my name. I want to change the name of my github anyway, away from my legal name

Also @malteserteresa you mentioned in Slack that you put only the people who had their portraits on the website in the docs but River is not on the website. Should we just do a poll in Slack to ask who wants to be in the docs and if we should use our real names or only our Github names?

I have deleted the names in the new version of the file. My idea is that we just explain our structure in this file and then in each repo README, people can add themselves if they want and how they want in a "Repository management" section. See this branch as an example.

djbusstop · 2020-04-10T09:27:44Z

PROJECT_MANAGEMENT.md

+- Feature implementation: details and suggested steps to be completed to add
+ the feature/fix the bug
+
+Bug and feature requests become feature implementations when someone has a


Same comment as above regarding this topic: advise to remove "Bug and". But also this is duplicate info. Which would be hard to manage. Maybe use this file as the source of truth? Not sure,

I will delete this from the PROJECT_MANAGEMENT file which will contain only general information about the team project boards and our sprints and meetings.

djbusstop · 2020-04-10T09:27:53Z

PROJECT_MANAGEMENT.md

+- [WIP]: indicate you are working on something but not finished in order to
+ avoid duplicated work, premature merges, or use this in the title with the
+  help wanted label if you want help/collaboration with the issue.
+- [MRG]: the contribution is complete and should be subjected to a detailed


Same as above

djbusstop · 2020-04-10T09:28:27Z

PROJECT_MANAGEMENT.md

+
+Product management FYIs:
+
+    We have meetings mid sprint to talk about issues for the next sprint. This


Use bullet points * or -

djbusstop · 2020-04-10T09:28:47Z

PROJECT_MANAGEMENT.md

+    Someone needs to take ownership of a board. Probably the same person hosting the meeting to make sure tasks are progressing. But without ownership, the board gets outdated and just is cluttered.
+
+
+How Features are decided


I have written about this in my RFC regarding feature spec

djbusstop · 2020-04-10T09:31:51Z

I noticed the updates. I have some feedback here that is more general:

I gave some feedback to the project management points and how I've been doing it for the web extension "team". But perhaps different groups want to use different patterns? The system I'm using is what I'm going for because it makes the most sense for me when I call meetings. But other people might use a different structure and that can also work really well. I would be hesitant to try to apply the extension development structure to other teams too early? Maybe it's too soon to refine the processes for the whole group down to reproducible parts? The people who take the initiative to call meetings would probably be better off with doing it the way it works for them rather than needing to refer to more documentation.

Also, this is a lot of documentation and I dunno if people will read it. I worry it would slow them down.

lucie-docs · 2020-04-11T15:08:42Z

Hi @malteserteresa, is it ok to pull your branch and directly insert corrections in there? I would like to restructure the information as it seems it is duplicated in two files and I'd also like to make the content shorter. @river-honer: I would take the comments you have already left into account of course. I just need write permission on this repo :)

lucie-docs · 2020-04-11T16:43:02Z

Also, FYI: I'm writing a piece for the blog and I would like to link our holocracy manifesto in there :)

djbusstop · 2020-04-12T18:05:07Z

@lucie-docs You can refer to this RFC as well opt-out-tools/opt-out#110

lucie-docs · 2020-04-13T07:43:54Z

@malteserteresa Chatted with River yesterday and turns out I have write permission on this repo :D So all I really need is your permission to directly modify the structure of your content :)

malteserteresa · 2020-04-13T08:28:13Z

@lucie-docs of course :) go forth and document!

lucie-docs · 2020-04-26T10:01:39Z

@malteserteresa and @river-honer, I've started shuffling things around and rewriting some files. Please check the following files directly in the branch: README, CONTRIBUTING, ORG_STRUCTURE, ROADMAP.
And let me know if this is going in the right direction!
I still have to work on PROJECT_MANAGEMENT + VISION_&_TOOLS after that.

malteserteresa · 2020-05-03T10:29:54Z

@lucie-docs honestly it reads so great now, just a one thing, Anna sadly no longer can be in the team so can you remove her from the contributing.md

Also I'm just wondering where we should put the diagram of the OOT architecture and a description of how the repos work together @river-honer do you have any ideas?

lucie-docs · 2020-05-03T10:46:07Z

@lucie-docs honestly it reads so great now, just a one thing, Anna sadly no longer can be in the team so can you remove her from the contributing.md

Also I'm just wondering where we should put the diagram of the OOT architecture and a description of how the repos work together @river-honer do you have any ideas?

Aw no, are we designer-less again? :( I was thinking of putting the diagram in our backend repository with the explanation of the OOT architecture. Is the diagram actually up-to-date?

malteserteresa · 2020-05-03T10:54:47Z

Yeah sadly :( after the Mozilla plug we'll do another "recruitment" drive

Add project management documentation

a6d6248

malteserteresa requested a review from lucie-docs April 8, 2020 07:33

Add more project management details and organisational structure details

4d573c4

djbusstop reviewed Apr 10, 2020

View reviewed changes

Lucie Le Naour added 13 commits April 25, 2020 13:37

Started reorganizing content around

1f788b0

Corrected URL for Open Collective

d46602a

Deleted some content in README

29aa080

Added missing info in CONTRIBUTING

23f2fb0

Little fix in README

d78216a

Added content in CONTRIBUTING

c3ce586

Content changes in CONTRIBUTING

15cec4c

Added TOC

b46b490

Changed TOC

87fe372

Small fix in CONTRIBUTING

1cd6273

Fixed CircleCI ref

544d426

Fixing CircleCI ref

15fdb2e

Changes in different files

acdd30d

Lucie Le Naour added 7 commits April 26, 2020 09:54

Added repo structure in README

a8684e9

Fixed repo structure

f8b36bc

Fixed repo structure

2d31730

Added repo management

9249545

Little fix

1ebb352

Little fix

2997943

Fix in disclaimer

bd91ccc

Lucie Le Naour added 4 commits April 26, 2020 10:56

Reorganized files

b50736d

Rewrote some content in the ORG_STRUCTURE file

2caac65

Added TOC in ORG_STRUCTURE

26e3db3

Finished rewriting ORG_STRUCTURE

05af227

Deleted Anna

944a8eb

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[WIP] Add project management documentation #69

[WIP] Add project management documentation #69

malteserteresa commented Apr 8, 2020

djbusstop commented Apr 8, 2020 •

edited

Loading

djbusstop Apr 10, 2020

lucie-docs Apr 26, 2020 •

edited

Loading

djbusstop Apr 10, 2020

lucie-docs Apr 26, 2020

djbusstop Apr 10, 2020

lucie-docs Apr 13, 2020

lucie-docs Apr 26, 2020

djbusstop Apr 10, 2020

lucie-docs Apr 26, 2020 •

edited

Loading

djbusstop Apr 10, 2020

djbusstop Apr 10, 2020

djbusstop Apr 10, 2020

djbusstop commented Apr 10, 2020

lucie-docs commented Apr 11, 2020 •

edited

Loading

lucie-docs commented Apr 11, 2020

djbusstop commented Apr 12, 2020

lucie-docs commented Apr 13, 2020

malteserteresa commented Apr 13, 2020

lucie-docs commented Apr 26, 2020

malteserteresa commented May 3, 2020

lucie-docs commented May 3, 2020

malteserteresa commented May 3, 2020


		Product management FYIs:

		We have meetings mid sprint to talk about issues for the next sprint. This

		Someone needs to take ownership of a board. Probably the same person hosting the meeting to make sure tasks are progressing. But without ownership, the board gets outdated and just is cluttered.


		How Features are decided

[WIP] Add project management documentation #69

Are you sure you want to change the base?

[WIP] Add project management documentation #69

Conversation

malteserteresa commented Apr 8, 2020

djbusstop commented Apr 8, 2020 • edited Loading

Choose a reason for hiding this comment

lucie-docs Apr 26, 2020 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

lucie-docs Apr 26, 2020 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

djbusstop commented Apr 10, 2020

lucie-docs commented Apr 11, 2020 • edited Loading

lucie-docs commented Apr 11, 2020

djbusstop commented Apr 12, 2020

lucie-docs commented Apr 13, 2020

malteserteresa commented Apr 13, 2020

lucie-docs commented Apr 26, 2020

malteserteresa commented May 3, 2020

lucie-docs commented May 3, 2020

malteserteresa commented May 3, 2020

djbusstop commented Apr 8, 2020 •

edited

Loading

lucie-docs Apr 26, 2020 •

edited

Loading

lucie-docs Apr 26, 2020 •

edited

Loading

lucie-docs commented Apr 11, 2020 •

edited

Loading