Let's Discuss Improving Documentation and Styling Guidelines To Help New and Old Contributors

so what do you think to much at once :slight_smile:

I'm sorry but i have no clue what this statement means. Ha.

I also wanted to get this discussion going but you sound like you have some pretty solud ideas there, @PackElend. i recently came to the personal realization that I'm a natural control freak and want to change that so i can be a better person overall. @laurent, if anyone should work on this feature, i vote Pack here to head it.

Although, i will say editor / ide of choice shouldn't be hard set as much as making sure that any linters are disabled. I found out first hand that eslint doesn't play nice with any other linters and can have adverse effects with the current rules setup.

Hello @PackElend, I’m trying to understand what you’re saying here, but if it’s about revamping the documentation, then count me in. I do a lot of writing and I enjoy documenting code, I also have a PR on Improving the Docs in Joplin which was successfully merged, so I will be very glad to add this to my GSOC goals

1 Like

Hi guys,

How are you?

I stumbled upon Joplin about a week ago and have used it since. Currently really busy combining work and university, so it comes in handy. I just read this post on the forum and thought maybe we can help each other out.

Let me explain:

I am a postgraduate student at VU University Amsterdam (Netherlands), currently following a course called “Digital Innovation & Virtual Organizing in a Global Setting”. We’re currently learning about open source development teams, in particular ways of working and coordination within these type of teams.

For an assignment, me and my group members are to pick a project, and find a way we can contribute by combining our theoretical knowledge and information we gather from having a chat with a couple of contributors.

How do you guys feel about this? We can’t code and do not know much about coding, but we might be able to help with something else, like creating a guideline template. We could also give some advice in terms of coordination and ways of working, and you’ll be able to add the more detailed coding-guidelines.

Of course, we’re also down to contribute in any other way, for example conducting some research in regard to user behaviour, trends in the market, a small survey at our uni etc. etc. You name it!
The only point of criteria is that it has to be feasible in a relatively small amount of time, because we’ve only been given about 1,5 week to write a report.

Would love to explain the idea a bit further and hear your opinions on this by having a quick chat with a couple of you.

Thanks!

Daniëlle Schultz
& the rest of my team

2 Likes

I am working with the recent codebase only these seems to be a bit more clear but what I see as the problem is the choice of the library we have used in the Joplin app for the ReactNativeClient project and the reason why I believe sometimes the android app works slow.

Instead of react-native-popup-dialog we can use react-native-modalbox it is fast.
Can we also update the react-navigation version, this will also improve the performance.

Also, let me know if I can help with updating the documentation.
The first time when I started with Joplin while setting up the development environment, document had some problem and suggest the changes.

2 Likes

that is my suggestion, using readthedocs.io
@danielleschultz you are more than welcome here to help us to make it an easy start.
The target should be to allow folks you and me to set up the proper IDE and repeat a PR easily

Wait for @laurent and @tessus for feedback

needs some feedback from @laurent

I pull in the latest contributor @marijawo as he should aware of this too.

there are surveys ongoing here:

summarizing these could be a good start

@amitsin6h, there are lots of things that can be improved on the mobile app, but changing components that work fine is very low priority.

2 Likes

@danielleschultz, that could be interesting but it’s not entirely clear to me what your project would be about? Perhaps if you could describe a concrete example - what the project will be about, what will be the process, etc.

Thanks for your reply @laurent. It is basically a mini-research project.

The purpose is to analyze a distributed team and identifying coordination practices. The aim is to learn more about your ways of coordinating by comparing it to what we learn in the theory of coordination of distributed work.

Based on our analysis and by chatting to you, we want to find a way in which we can contribute to the project, based on our skills. It’s about trying to find a way to help out while gaining some hands-on experience. So this could be a small market research, analysis about the viability of the product, a user experience test, or by writing an advisory report in regard to coordination, which could include certain guidelines, templates, etc.

If you have some ideas or any kind of thing you have been wanting to research/do for a while, but have not found the time or the right person, then we can perhaps give it a shot.

If you want I can send you the assignment guide?
It would mean a lot. We would love to help out!

Daniëlle
d.schultz@student.vu.nl

1 Like

If Joplin get accepted for GSoC we will enter new lands in regard to communication anyway :slight_smile: as there is strict timeline.

1 Like

Hi @laurent!
Would love to hear what you think of my post above.

Thanks.

@danielleschultz, you mentioned “small market research, analysis about the viability of the product, a user experience test” and all that would be useful to the project, with a preference for user experience test.

I think the biggest UX issue at the moment is the mobile app so if a user experience study could be done on it, it would help us identify what parts of it could be improved and how. That’s just an idea, assuming it would fit within the scope of your mini-project.

Market research I guess would also help us prioritise development work.

1 Like

I 100% agree with that. The mobile app is the source of most of my UX frustrations and probably other people are feeling the same.

@danielleschultz, with other multiplatform apps such as this, I’ve noticed many developers create different looks and feels for both Android and iOS devices. I’m assuming that’s due to how both platforms have their own different feels to their interfaces and those devs are trying to make the app feel like it belongs there. Do you have any ideas on this?

@Runo-saduwa, what kind of documentation are you wanting to contribute? As posted here and linked above by Pack, ReadTheDocs.io is a thing and, now that Joplin is officially a part of GSoC for 2020, let's get this figured out and get going with it ASAP. :smiley:

@bedwardly-down thanks for filling me in,
Well, like I said earlier, I love to write and organize things, so I can contribute to any part of the documentation to make it great

I’ll also need to readthedocs.io to understand how it’s used, if you have a plan, please go ahead and We’ll take it from there

I’m off work today and am briefly looking into it myself. I don’t have much of a clue about how to use it but am willing to learn. I also think that having a #GSoC-Doc Discord channel for everyone that is contributing directly to this project would help everyone stay up to date better. What do you guys think?

I really think this would be an excellent project to get going and submitted for GSoC

it is good for quick talks, but information there are lost, so anything what shall be available in the community has to be in the forum.
We are working on it to improve the flow of information.

I'm not that much further, I only noticed that it is used very often and you can quickly create structures docs.
Give me some idea of the first structure and we will continue from there.
Idea:

  • Architecture
  • Style
  • Def tools
  • Build
    • checks
  • Contribution
    • style
    • show proof of fix

Here’s my thoughts so far:

If you want all contributors to use the same tools and whatnot, you’ll need to settle for Visual Studio Code or something similar. There aren’t really any cross platform IDEs for React and Javascript that are universal to all major platforms, so my recommendation is the next best thing. It also would require Arch and Gentoo users to either downgrade their kernel to 5.4 or change Linux distributions altogether due to multiple bugs that are predominantly on rolling release distributions due to their bleeding edge nature. And these bugs are primarily related to Electron and Chromium.

OBS-Studio is a great option for screen recording for those that want to show their tests in real time and use video / gif as their proof of fix. It works extremely well across all platforms.

Each platform has their own apps for taking screenshots of the desktop and apps that are being run / tested. Scrot is a great command line tool for Linux. Screengrab is one of the better gui based ones that has support for a variety of resolutions and compression types. It’s also a default app in many desktop environments.

Some projects require github contributions to be made by users that use their real names and have some kind of identifying information (like a portfolio or resume attached to their accounts) to allow the devs to verify that they are qualified to work on the project. This is something that would be important to decide on and add to the documentation.

There should be set rules and guidelines for how tests should be performed and those that don’t show valid results (like my video example above), their bug reports and fixes should not be accepted.

Minimum requirements of tool knowledge to be able to contribute and / or test Joplin.

1 Like

I expect that to be in the proposal:

About me

Provide your contact information (IRC nick, email, IM, phone) and write a few sentences about you and why you think you are the best for this job. Prior contributions to Joplin are required; list your commits. Name people (other developers, students, professors) who can act as a reference for you. Mention your field of study if necessary. Now is the time to join the relevant irc/telegram channels, mail lists and blog feeds. We want you to be a part of our community, not just contribute your code.

Tell us if you are submitting proposals to other organizations, and whether or not you would choose Joplin if given the choice.

Is that enough?