5 ms·

Agree. I am in the process of launching a new Open-Source project for Civil/Mechanical/Chemical engineers. In my gut feelings, this software shall be used by at

Agree. I am in the process of launching a new Open-Source project for Civil/Mechanical/Chemical engineers. In my gut feelings, this software shall be used by at least 10x Engineers compared to the number who may actually help code it. So, there must be a way for those Users to contribute back to the project. Even if it is simply improving the docs. If I use a static site generator such as Hugo to generate the docs (EDIT: user manual in our language), there must be a way for users (not developers) to submit correction/updates to the docs. I can't expect them to create a GitHub issue either, so I have to think about a way to do this. i.e. In this case, non-code contributions are far more important than the actual pull request.

dsgnr 3y ago
[dead]
m463 3y ago
I would like frictionless contribution. I know projects have to protect themself, but creating an account, or entering an email address or filling out a captcha is friction maybe enter comment in this form and click to submit feedback.
- zilti 3y ago
  Guix does it right, and Sourcehut as well. No accounts or captchas, just mail in the patches.
  - Tmpod 3y ago
    This. An e-mail based workflow is much better for non-developers because you don't really need to create an account and faff around with an unfamilar plaform, it's just e-mail. The issue then becomes using a good local VCS UI and also a good remote UI. I'm not familiar with Guix, but sourcehut, despite not being quite there yet, has lots of potential imo. Side note: Unfortunately, it seems like development has slowed down. I see some activity in the mailing lists, but there hasn't been a "What's cooking" post in ages, nor have I noticed any real changes in a while. @drewdevault @emersion what's going on?
Closi 3y ago
Create a Wiki :)
bigger_cheese 3y ago
> am in the process of launching a new Open-Source project for Civil/Mechanical/Chemical engineers I'm in this group (I'm a Materials/Chem eng). We have recently started using media wiki internally for all sorts of documentation related things it has taken off very quickly. Over the years there has been other solutions pushed onto us like confluence and sharepoint those never really gained any traction. Having plugins enabled (like math equation editor) is important - Engineering documentation involves Math equations. The wiki lets you use markup like this "\frac{dC}{dO} = \frac{10}{\alpha+\frac{\beta}{([C]-C_{min})^{DC}}}" but also has visual editor.
- ramshanker 3y ago
  Excellent. Same here. I have got Media Wiki installed in one of our internal servers and currently in the processes of updating the configurations to comply with Security Auditor requirements. I hope it takes off similarly over here.

dsgnr 3y ago

[dead]

m463 3y ago

I would like frictionless contribution. I know projects have to protect themself, but creating an account, or entering an email address or filling out a captcha is friction maybe enter comment in this form and click to submit feedback.

zilti 3y ago
Guix does it right, and Sourcehut as well. No accounts or captchas, just mail in the patches.
- Tmpod 3y ago
  This. An e-mail based workflow is much better for non-developers because you don't really need to create an account and faff around with an unfamilar plaform, it's just e-mail. The issue then becomes using a good local VCS UI and also a good remote UI. I'm not familiar with Guix, but sourcehut, despite not being quite there yet, has lots of potential imo. Side note: Unfortunately, it seems like development has slowed down. I see some activity in the mailing lists, but there hasn't been a "What's cooking" post in ages, nor have I noticed any real changes in a while. @drewdevault @emersion what's going on?

Closi 3y ago

Create a Wiki :)

bigger_cheese 3y ago

> am in the process of launching a new Open-Source project for Civil/Mechanical/Chemical engineers I'm in this group (I'm a Materials/Chem eng). We have recently started using media wiki internally for all sorts of documentation related things it has taken off very quickly. Over the years there has been other solutions pushed onto us like confluence and sharepoint those never really gained any traction. Having plugins enabled (like math equation editor) is important - Engineering documentation involves Math equations. The wiki lets you use markup like this "\frac{dC}{dO} = \frac{10}{\alpha+\frac{\beta}{([C]-C_{min})^{DC}}}" but also has visual editor.

ramshanker 3y ago
Excellent. Same here. I have got Media Wiki installed in one of our internal servers and currently in the processes of updating the configurations to comply with Security Auditor requirements. I hope it takes off similarly over here.