From 49898d01b5ef23fb944414923a71c19692e8086e Mon Sep 17 00:00:00 2001 From: Laurent Cozic Date: Wed, 20 Nov 2019 18:47:32 +0000 Subject: [PATCH] Doc: Added GSoC to website --- Tools/build-website.js | 12 +- docs/api/index.html | 5 +- docs/changelog/index.html | 5 +- docs/changelog_cli/index.html | 5 +- docs/clipper/index.html | 5 +- docs/debugging/index.html | 5 +- docs/desktop/index.html | 5 +- docs/donate/index.html | 5 +- docs/e2ee/index.html | 5 +- docs/faq/index.html | 5 +- docs/gsoc/idea1_nextcloud.html | 396 +++++++++++++++ docs/gsoc/idea2_sharing.html | 373 ++++++++++++++ docs/gsoc/idea3_tagging.html | 373 ++++++++++++++ docs/gsoc/idea4_search.html | 364 ++++++++++++++ docs/gsoc/idea5_password_per_note.html | 369 ++++++++++++++ docs/gsoc/index.html | 471 ++++++++++++++++++ docs/index.html | 5 +- docs/markdown/index.html | 13 +- docs/mobile/index.html | 5 +- docs/prereleases/index.html | 5 +- docs/spec/index.html | 5 +- docs/stats/index.html | 5 +- docs/terminal/index.html | 5 +- ...Idea#1_Nextcloud.md => idea1_nextcloud.md} | 2 +- ...019_Idea#2_sharing.md => idea2_sharing.md} | 5 +- ...019_Idea#3_tagging.md => idea3_tagging.md} | 4 +- ...C2019_Idea#4_Search.md => idea4_search.md} | 2 + ...per Note.md => idea5_password_per_note.md} | 2 +- readme/{summer_of_code.md => GSoC/index.md} | 106 ++-- 29 files changed, 2490 insertions(+), 77 deletions(-) create mode 100644 docs/gsoc/idea1_nextcloud.html create mode 100644 docs/gsoc/idea2_sharing.html create mode 100644 docs/gsoc/idea3_tagging.html create mode 100644 docs/gsoc/idea4_search.html create mode 100644 docs/gsoc/idea5_password_per_note.html create mode 100644 docs/gsoc/index.html rename readme/GSoC/{GSoC2019_Idea#1_Nextcloud.md => idea1_nextcloud.md} (97%) rename readme/GSoC/{GSoC2019_Idea#2_sharing.md => idea2_sharing.md} (86%) rename readme/GSoC/{GSoC2019_Idea#3_tagging.md => idea3_tagging.md} (97%) rename readme/GSoC/{GSoC2019_Idea#4_Search.md => idea4_search.md} (68%) rename readme/GSoC/{GSoC2019_Idea#5_Password per Note.md => idea5_password_per_note.md} (96%) rename readme/{summer_of_code.md => GSoC/index.md} (63%) diff --git a/Tools/build-website.js b/Tools/build-website.js index 7f299d87ce..49691ff53d 100644 --- a/Tools/build-website.js +++ b/Tools/build-website.js @@ -190,7 +190,9 @@ https://github.com/laurent22/joplin/blob/master/{{{sourceMarkdownFile}}} padding-left: 2em; margin-bottom: 0; display: table-cell; - min-width: 250px; + /* min-width: 250px; */ + /* For GSoC: */ + min-width: 470px; } .nav ul li { display: inline-block; @@ -275,6 +277,7 @@ https://github.com/laurent22/joplin/blob/master/{{{sourceMarkdownFile}}}
  • Forum
  • Menu
    • +
  • Google Summer of Code 2010
    • + + + GSoC: Idea 1: Nextcloud | Joplin + + + + + + + + + + + + + +
    + +
    + +

    oplin

     +

    An open source note taking and to-do application with synchronisation capabilities.

    +
    + +
    +
    + +
    + + +
    +
    +
    + +
    + +

    GSoC: Nextcloud notes integration (Web client)🔗

    +

    What is the goal of the project🔗

    +

    There is the community's wish to have the notes integrated Nextcloud, so that Notes can be sought by Nextcloud itsself. Although this idea focuses on Nextcloud it shall allow to extend it to other collaboration applications going beyond the current scope of Synchronisation.

    +

    There is already the web application what may can be integrated in collaboration application

    +

    what shall be answered in the application🔗

    +

    Why shall this idea be realized🔗

    +

    Allowing broader use of the application and better integration of the existing open source world, we don't want to invent the wheel twice

    +

    Who is talking about it🔗

    +

    The idea is outcome of (but not limited to) of some discussion taking place in the Forum and on GitHub:

    + +
    +

    COMMENTS:

    +
      +
    1. +

      “Nextcloud notes integration (Web client)” is not well defined. What would be nice is a built-in Nextcloud web client for Joplin. But the top post in there is about something else that won’t be changed (explained in the FAQ: https://joplinapp.org/faq/#is-it-possible-to-use-real-file-and-folder-names-in-the-sync-target)

      +
      2. +
    2. +

      That would be interesting to know what they think about such an integration and how they see it because it’s an old subject, we (the staff) are periodically debating:

      + +

      I imagined they just need a joplin-api in PHP and “plug” it on the right datasource to switch between “Nextcloud native note/Qownote” to Nextcloud/Qownnote “Joplin note”.

      +
      3. +
    3. +

      “How is WebDAV sync implemented?” appears twice. It should only be in Summer of Doc.

      +
      4. +
    + +
    + + Improve this doc + +
    + + +
    +Copyright (c) 2016-2019 Laurent Cozic +
    + + diff --git a/docs/gsoc/idea2_sharing.html b/docs/gsoc/idea2_sharing.html new file mode 100644 index 0000000000..4f1a65c715 --- /dev/null +++ b/docs/gsoc/idea2_sharing.html @@ -0,0 +1,373 @@ + + + + + + + GSoC: Idea 2: Sharing | Joplin + + + + + + + + + + + + + +
    + +
    + +

    oplin

     +

    An open source note taking and to-do application with synchronisation capabilities.

    +
    + +
    +
    + +
    + + +
    +
    +
    + +
    + +

    GSoC: Sharing🔗

    + +

    "Please give the ability to share from another Android app into Joplin": This is already done

    + +
    + + Improve this doc + +
    + + +
    +Copyright (c) 2016-2019 Laurent Cozic +
    + + diff --git a/docs/gsoc/idea3_tagging.html b/docs/gsoc/idea3_tagging.html new file mode 100644 index 0000000000..9425c1d152 --- /dev/null +++ b/docs/gsoc/idea3_tagging.html @@ -0,0 +1,373 @@ + + + + + + + GSoC: Idea 3: Tagging | Joplin + + + + + + + + + + + + + +
    + +
    + +

    oplin

     +

    An open source note taking and to-do application with synchronisation capabilities.

    +
    + +
    +
    + +
    + + +
    +
    +
    + +
    + +

    GSoC: Tag handling🔗

    + +

    “[Feature Request] Tags on whole markdown lines #1498”: I prefer we remove this as this too far from standard markdown.

    +

    “Feature request: set @tags from markdown editor #1407”. I prefer if we remove this too for the same reason. I think tagging is already easy since there’s a keyboard shortcut for it. Maybe back then there wasn’t.

    +

    “So many tags #1221”: Was a bug, which has been fixed.

    + +
    + + Improve this doc + +
    + + +
    +Copyright (c) 2016-2019 Laurent Cozic +
    + + diff --git a/docs/gsoc/idea4_search.html b/docs/gsoc/idea4_search.html new file mode 100644 index 0000000000..354e8a9c9c --- /dev/null +++ b/docs/gsoc/idea4_search.html @@ -0,0 +1,364 @@ + + + + + + + GSoC: Idea 4: Search | Joplin + + + + + + + + + + + + + +
    + +
    + +

    oplin

     +

    An open source note taking and to-do application with synchronisation capabilities.

    +
    + +
    +
    + +
    + + +
    +
    +
    + +
    + +

    GSoC: Search engine improvements🔗

    +

    Search engine improvements

    + +
    + + Improve this doc + +
    + + +
    +Copyright (c) 2016-2019 Laurent Cozic +
    + + diff --git a/docs/gsoc/idea5_password_per_note.html b/docs/gsoc/idea5_password_per_note.html new file mode 100644 index 0000000000..57cad9434a --- /dev/null +++ b/docs/gsoc/idea5_password_per_note.html @@ -0,0 +1,369 @@ + + + + + + + GSoC: Idea 5: Password per Note | Joplin + + + + + + + + + + + + + +
    + +
    + +

    oplin

     +

    An open source note taking and to-do application with synchronisation capabilities.

    +
    + +
    +
    + +
    + + +
    +
    +
    + +
    + +

    GSoC: Additinal protection per note🔗

    + +

    Password or pin protection: It’s very unclear what people want. It seems the threat model is you give your unlocked phone or laptop to someone, and you don’t want them to see your notes. But of course, the solution is to not do that. All devices these days support multiple accounts, so there’s no point giving their unlocked device to someone they don’t trust. I think we should remove this issue until it’s betted defined. Perhaps it should go to a different category like, “to be specified”. We need to know what’s the threat model, what people want. I’ve heard dozens of variations (locking the app, obfuscating the data, encrypting the data, encrypting a note, a notebook, encrypting a part of a note, etc.) so it’s unclear what needs to be done. I guess for me it seems so unnecessary that I can’t quite wrap my head around it.

    + +
    + + Improve this doc + +
    + + +
    +Copyright (c) 2016-2019 Laurent Cozic +
    + + diff --git a/docs/gsoc/index.html b/docs/gsoc/index.html new file mode 100644 index 0000000000..a35ca03790 --- /dev/null +++ b/docs/gsoc/index.html @@ -0,0 +1,471 @@ + + + + + + + Google Summer of Code | Joplin + + + + + + + + + + + + + +
    + +
    + +

    oplin

     +

    An open source note taking and to-do application with synchronisation capabilities.

    +
    + +
    +
    + +
    + + +
    +
    +
    + +
    + +

    Google Summer of Code🔗

    +

    Joplin has a young but well proven history. It all started by single idea but is rising more and more commitment as well as demands.

    +

    Joplin is about to make another big step to answers these demands by applying at Google Summer of Code. All students and Joplin users and developers are welcome to participate in the hopefully first year Summer of Code program with Joplin. Here's how.

    +

    Mentors, administrators and students: read Summer of Code occasionally. Also read the Summer of Code FAQ.

    +

    All participants will need a Google account in order to join the program. So, save time and create one now. In addition, all participants need to join the Joplin Forum.

    +

    Programming Language🔗

    +

    All applications share the same back-end written in JavaScript (Node.js), with Redux for state management. The back-end runs locally.

    +

    The GUI's, as listed on the Joplin's website are:

    +
      +
    • ClL: terminal-kit
      • +
    • Desktop: Electron
      • +
    • Mobile: React Native
      • +
    +

    More details can be found on:

    + +

    Moreover there are community driven projects such as:

    + +

    Submissions and ideas for projects in any other language should specifically mention the choice.

    +

    Instructions for students🔗

    +

    Students wishing to participate in Summer of Code must realize, that this is a important professional opportunity. You will be required to produce applicable and readable code for Joplin in 3 months. Your mentors, will dedicate a portion of their time to mentoring you. Therefore, we seek candidates who are committed to helping Joplin and its community long-term and are willing to both do quality work, and be proactive in communicating with your mentor(s).

    +

    You don't have to be a proven developer -- in fact, this whole program is meant to facilitate joining Joplin and other Open Source communities. However, experience in coding and/or experience with the above mentioned programming languages and the applications is welcome.

    +

    Currently there is only How to contribute and How to build but more details are bout to come on how to interact and how to commit.
    +In general it can be said, that question shall be asked early and clearly, given everyone the possibility to understand why you want to have this question answered and how it helps to achieve the project's goal.

    +

    Before you can be accepted as a student we expect you to fix some bugs and link that work on your proposal.

    +

    You should start learning the components that you plan on working on before the start date. Support can be found in the forum and on our dedicated discourse channel.

    +

    Do not worry, the the timeline from Google reserves a lot of time for bonding periods but use that time wisely. Good communication is key. To allow us to respond quickly tag your questions with #GSoC and #2020.

    +

    You should plan to communicate with your team several times per week, and formally report progress and plans weekly. You are free to chose the format, it can be an sophisticated online document or simple continuous blog on GitHub.
    +Moreover, we require that you come to clear agreement on how to commit, test and build. We don't see us loosing time on how to test instead accentually testing your commits.

    +

    Students who neglect active communication will be failed.

    +

    General instructions🔗

    +

    First of all, please read the above referenced resources and the GSoC FAQ. Pay special attention to the Eligibility section of the FAQ.

    +

    Recommended steps🔗

    +
      +
    1. Join the Joplin Forum, introduce yourself, and meet your fellow developers in the Development category
      2. +
    2. Read Student proposal guidelines and the GSoC Student Manual
      3. +
    3. Take a look at the [list of ideas]. You can have you own idea addeed by posting it in the Features category
      4. +
    4. Come up with project that you're interested in and discusse it in Development category
      5. +
    5. Write a first draft and get someone to review it
      6. +
    6. Remember: you must link to work such as commits in your proposal. A private place will be created wihtinn the forum for that purposes.
      7. +
    7. Read How to write a kickass proposal for GSoC
      8. +
    8. Submit proposal using Google's web interface ahead of the deadline
      9. +
    9. Submit proof of enrollment well ahead of the deadline
      10. +
    +

    Coming up with an interesting idea is probably the most difficult part. It should be something interesting for Joplin, for Open Source in general and for you. And it must be something that you can realistically achieve in the time available to you.

    +

    A good start is finding out what the most pressing issues are in the projects in which you are interested. Join the forum and subscribe to GitHub repository for that project or go into its discourse channel: meet developers and your potential mentor, as well as start learning the code-base. We recommend strongly getting involved in advance of the beginning of GSoC, and we will look favorably on applications from students who have already started to act like Open Source developers.

    +

    Student proposal guidelines🔗

    +

    A project proposal is what you will be judged upon. Write a clear proposal on what you plan to do, the scope of your project, and why we should choose you to do it. Proposals are the basis of the GSoC projects and therefore one of the most important things to do well. The proposal is not only the basis of our decision of which student to choose, it has also an effect on Google's decision as to how many student slots are assigned to Joplin.

    +

    Below is the application template:

    +
    +

    Introduction

    +

    Every software project should solve a problem. Before offering the solution (your Google Summer of Code project), you should first define the problem. What’s the current state of things? What’s the issue you wish to solve and why? Then you should conclude with a sentence or two about your solution. Include links to discussions, features, or bugs that describe the problem further if necessary.

    +

    Project goals

    +

    Be short and to the point, and perhaps format it as a list. Propose a clear list of deliverables, explaining exactly what you promise to do and what you do not plan to do. “Future developments” can be mentioned, but your promise for the Google Summer of Code term is what counts.

    +

    Implementation

    +

    Be detailed. Describe what you plan to do as a solution for the problem you defined above. Include technical details, showing that you understand the technology. Illustrate key technical elements of your proposed solution in reasonable detail. Include writing unit tests throughout the coding period, as well as code documentation. These critical elements cannot be left to the last few weeks of the program. If user documentation will be required, or apidox, etc. these should be written during each week, not at the end.

    +

    Timeline

    +

    Show that you understand the problem, have a solution, have also broken it down into manageable parts, and that you have a realistic plan on how to accomplish your goal. Here you set expectations, so don’t make promises you can’t keep. A modest, realistic and detailed timeline is better than promising the impossible.

    +

    If you have other commitments during GSoC, such as a job, vacation, exams, internship, seminars, or papers to write, disclose them here. GSoC should be treated like a full-time job, and we will expect approximately 40 hours of work per week. If you have conflicts, explain how you will work around them. If you are found to have conflicts which you did not disclose, you may be failed.

    +

    Open and clear communication is of utmost importance. Include your plans for communication in your proposal; daily if possible. You will need to initiate weekly formal communication such as a blog post on to be agreed placed. Lack of communication will result in you being failed.

    +

    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.

    +

    Other things to think about:

    +
      +
    • +

      Are you comfortable working independently under a supervisor or mentor who is several thousand miles away, and perhaps 12 time zones away? How will you work with your mentor to track your work? Have you worked in this style before?

      +
      • +
    • +

      If your native language is not English, are you comfortable working closely with a supervisor whose native language is English? What is your native language, as that may help us find a mentor who has the same native language?

      +
      • +
    • +

      After you have written your proposal, you should get it reviewed. Do not rely on the Joplin mentors to do it for you via the web interface, although we will try to comment on every proposal. It is wise to ask a colleague or a developer to critique your proposal. Clarity and completeness are important.

      +
      • +
    +
    +

    Hints🔗

    +

    Submit your proposal early: early submissions get more attention from developers because that they have more time to read them. The more people see your proposal, the more it will be discussed.

    +

    Do not leave it all to the last minute: while it is Google that is operating the webserver, it would be wise to expect a last-minute overload on the server. So, be sure you send your application and proof of enrollment before the final rush. Also, applications submitted very late will get the least attention from mentors, so you may get a lower vote because of that. Submitting a draft early will give time for feedback from prospective mentors.

    +

    Keep it simple: Be concise and precise. Provide a clear, descriptive title. "My Project" is the worst possible title!

    +

    Know what you are talking about: Do not submit proposals that cannot be accomplished over a summer or that are not related to Joplin. If your idea is unusual, be sure to explain why you have chosen Joplin to be your mentoring organization.
    +There could be exceptional reason to accept proposal what cannot be finished over the sumer if either it is clearly recognisable that there will be commitment beyond the summer period or the project can be well separated in sub-project. If you want to go that way, your proposal must be very easy readable to allow us to evaluate the changes of a project going through several coding programs.

    +

    Aim wide: submit more than one proposal. You are allowed to submit to another organisation as well. If you do submit more than one proposal, tell us that and which proposal you would choose, if both were selected. Former students would advise you to do one or two kick-ass proposals rather than trying to do three.

    +

    Accepted Students🔗

    +

    Your primary responsibility is finishing your project under the guidance of your mentors. To do that, you must submit code regularly and stay in frequent and effective communication with your mentors and team. To pass the evaluations, you must do both the communication and the coding plus documentation.

    +

    All students will create a report page by tool up to their choice. Keep this up-to-date, as this is one of our primary evaluation tools.

    +

    Instructions for mentors🔗

    +

    Ideas🔗

    +

    If you're a Joplin developer or motivated user and you wish to participate in Summer of Code, make a proposal in the the Features category of the Joplin Forum, based what your Joplin project needs.

    +

    If you wish to mentor, please read the GSoC Mentor Guide and the Summer of Code FAQ. Also, please contact the staff and get the go-ahead from them before editing the ideas page, adding your idea.

    +

    Your idea proposal should be a brief description of what the project is, what the desired goals would be, what the student should know and an email address for contact. Students are not required to follow your idea to the letter, so regard your proposal as inspiration for the students.

    +

    Mentoring🔗

    +

    Anyone developer can be a mentor if you meet the GSoC eligiibity requirements. We will potentially assign a student to you who has never worked on such a large project and will need some help. Make sure you're up for the task. Mentoring takes time, and lots and lots of communication.

    +

    Before subscribing yourself as a mentor, please make sure that the staff is aware of that. Ask them to send the Summer of Code Administrators an email confirming your involvement in the team. This is just a formality to make sure you are a real person we can trust; the administrators cannot know all active developers by their Google account ID. Then drop us an message in the forum.

    +

    Prospective mentors should read the mentoring guide. Also, Federico Mena-Quintero has written some helpful information based on his experiences in previous years. His HOWTO has some useful suggestions for anyone planning to mentor this year.

    +

    You will subscribe to the relvant tags in the forum to discuss ideas. You will need to read the proposals as they come in, and vote on the proposals. Daily communication is required with your student during the Community Bonding period, and multiple times per week during the coding period.

    +

    Finally, know that we will never assign you to a project you do not want to work on. We will not assign you more projects than you can/want to take on either. And you will have a backup mentor, just in case something unforeseen takes place.

    +

    Ideas🔗

    + + +
    + + Improve this doc + +
    + + +
    +Copyright (c) 2016-2019 Laurent Cozic +
    + + diff --git a/docs/index.html b/docs/index.html index 6481707103..a1c3d3ac02 100644 --- a/docs/index.html +++ b/docs/index.html @@ -186,7 +186,9 @@ https://github.com/laurent22/joplin/blob/master/ padding-left: 2em; margin-bottom: 0; display: table-cell; - min-width: 250px; + /* min-width: 250px; */ + /* For GSoC: */ + min-width: 470px; } .nav ul li { display: inline-block; @@ -271,6 +273,7 @@ https://github.com/laurent22/joplin/blob/master/
  • Forum
  • Menu
    • +
  • Google Summer of Code 2010