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

[Potential] contributors need plans/in progress documentation #261

Closed
mi-hol opened this issue Dec 6, 2022 · 15 comments
Closed

[Potential] contributors need plans/in progress documentation #261

mi-hol opened this issue Dec 6, 2022 · 15 comments
Assignees
Labels
help wanted Extra attention is needed low-hanging-fruit needs-more-info requestor or contributor needs to provide feedback

Comments

@mi-hol
Copy link
Contributor

mi-hol commented Dec 6, 2022

https://github.com/rusefi/rusefi/wiki/Dev-Status
https://github.com/rusefi/rusefi/blob/master/misc/work_in_progress.md

@rusefillc "Current" status seems to be of about one year ago.

I see it as a great "marketing" document.
Assuming all relevant issues have been link per feature I could update status icons, but a thorough review will be required by technical expert(s) before it should be merged.

Should this task be a priority?

@rusefillc
Copy link
Contributor

@mck1117 @pk386 @chuckwagoncomputing what do you think?

I probably vote to simply remove the page. Reality shows that we can only maintain the state of .ini files - if it's in the .ini files we have it, if it's not in the files - we do not have it.

@rusefillc
Copy link
Contributor

@mck1117 @pk386 @chuckwagoncomputing second round?

@chuckwagoncomputing
Copy link
Member

It seems like a nice page to have - if it's actually referred to.

@rusefillc
Copy link
Contributor

it is definitely abandoned. I've forgotten about it for sure, and it has out of date info!

@rusefillc
Copy link
Contributor

https://github.com/rusefi/rusefi/blob/master/misc/work_in_progress.md is another equally abandoned "status" file.

@mi-hol
Copy link
Contributor Author

mi-hol commented Dec 11, 2022

It seems like a nice page to have - if it's actually referred to.

Very useful for potential buyers, but if it's not reflecting current capabilities, a lost sales opportunity is the result.

@rusefillc rusefillc changed the title update of rusefi_documentation/Dev/Dev-Status.md required plans/in progress documentation Dec 11, 2022
@rusefillc rusefillc changed the title plans/in progress documentation [Potential] contributors need plans/in progress documentation Dec 11, 2022
@rusefillc
Copy link
Contributor

This is related to #111

We have two "in progress" documents and three(!!!) sources of current feature set

@mi-hol
Copy link
Contributor Author

mi-hol commented Dec 11, 2022

We have ... three(!!!) sources of current feature set

good catch.
@rusefillc please add URL links for feature set.
This will allow to understand the issue and to create a plan to fix it

@mi-hol
Copy link
Contributor Author

mi-hol commented Dec 11, 2022

@rusefi/doc-team
To facilitate planning next milestone for documentation, I created a new label "feedback needed" and assigned this label to issues with unclear status or long due activities.
As the next step I'll try to assign it to the correct owner for resolution.
Please provide feedback in case I got this wrong

@mi-hol mi-hol pinned this issue Dec 11, 2022
@mi-hol
Copy link
Contributor Author

mi-hol commented Dec 11, 2022

@rusefi/doc-team
first progress:

  • 11of 63 issues have been closed.

next step:

  • prioritize remaining 52 issues.

My proposal is to work on "bugs" first.

Would love to read comments or concerns :)

@mi-hol mi-hol mentioned this issue Dec 11, 2022
@mi-hol mi-hol added the help wanted Extra attention is needed label Dec 15, 2022
@mi-hol mi-hol self-assigned this Dec 15, 2022
@mi-hol mi-hol added the needs-more-info requestor or contributor needs to provide feedback label Dec 27, 2022
@rusefillc
Copy link
Contributor

somehow this has started with a desire for plans and switched into asking me to edit content. I am confused and overwhelmed, my default response is to run away

@mi-hol
Copy link
Contributor Author

mi-hol commented Jan 31, 2023

somehow this has started with a desire for plans and switched into asking me to edit content.

with a single point of control, decisions that are not taken, block everyone on a team (that would like to contribute) from making progress.

I am confused and overwhelmed, my default response is to run away

Will not cure the problem.
The problem is a typical project management problem encountered already in early 1970s at IBM.
"Complex programming projects cannot be perfectly partitioned into discrete tasks that can be worked on without communication between the workers and without establishing a set of complex interrelationships between tasks and the workers performing them."

It triggered the creation of THE BOOK for project management "The Mythical Man Month"
https://en.wikipedia.org/wiki/The_Mythical_Man-Month#Communication
"Communication
To avoid disaster, all the teams working on a project should remain in contact with each other in as many ways as possible (e-mail, phone, meetings, memos, etc.). Instead of assuming something, implementers should ask the architect(s) to clarify their intent on a feature they are implementing, before proceeding with an assumption that might very well be completely incorrect. The architect(s) are responsible for formulating a group picture of the project and communicating it to others."

@rusefillc
Copy link
Contributor

For last 24 months 90% of the changes are done by two contributors - @mck1117 and myself. @mck1117 and myself are totally NOT communicating. Once we remove @mck1117 as non-communicating entity that leaves myself. As of today my plans for this project are unclear.

Many things are just consequences of the above statement.

@pk386 FYI.

@rusefillc
Copy link
Contributor

@chuckwagoncomputing see drama above - it reminds me of rusefi/rusefi#5019

my problem with rusefi/rusefi#5019 is I do not major value, I definitely see at least minor damage. Inability to make the decision fast takes me to the uncomfortable for me zone of "this needs proper attention but no motivation to invest major decision making effort into what seems like something not important"

@chuckwagoncomputing chuckwagoncomputing unpinned this issue Jan 31, 2023
@mi-hol
Copy link
Contributor Author

mi-hol commented Jan 31, 2023

For last 24 months 90% of the changes are done by two contributors

at least for doc repo there are now others too :)
image

@mi-hol mi-hol reopened this Jan 31, 2023
@mi-hol mi-hol closed this as completed Jun 17, 2023
@rusefi rusefi deleted a comment from mi-hol Jun 17, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
help wanted Extra attention is needed low-hanging-fruit needs-more-info requestor or contributor needs to provide feedback
Projects
None yet
Development

No branches or pull requests

3 participants