Community

    • Login
    • Search
    • Recent
    • Tags
    • Popular
    • Users
    • Groups
    • Search

    Documentation is like sex...

    Announcements
    4
    8
    2770
    Loading More Posts
    • Oldest to Newest
    • Newest to Oldest
    • Most Votes
    Reply
    • Reply as topic
    Log in to reply
    This topic has been deleted. Only users with topic management privileges can see it.
    • donho
      donho last edited by donho

      …when it’s good, it’s very, very good; when it’s bad, it’s better than nothing.

      As you can see, Notepad++ Wiki’s content is very outdated. For the security reason, Notepad++ Wiki is in read only currently, and it will be replaced by new Notepad++ User Manual (from scratch).
      Notepad++ User Manual will be built collaboratively (in Markdown) on GitHub. So anyone can contribute it by submitting the pull requests.

      The main sections (the structure of this user manual) that I can enumerate for the moment are:

      • Introduction
      • Getting start
      • Programing Languages
      • User Defined Language System
      • Searching
      • Session
      • Macros
      • Auto-completion
      • Plugins
      • Preferences
      • Themes
      • Command Line
      • Shell Extension
      • Binary Translation
      • Updating

      [Edited 23/05/2019]
      I need your vision for this define to cover Notepad++ in every aspect.
      notepad-plus-plus/npp-usermanual is reloaded and it will be used as the Notepad++ document official repository:
      https://github.com/notepad-plus-plus/npp-usermanual/

      The party begins. You’re contribution (PR) are welcome!

      1 Reply Last reply Reply Quote 8
      • PeterJones
        PeterJones last edited by PeterJones

        That’s awesome. Thanks, @donho! Is it going to be in the existing notepad-plus-plus/npp-usermanual repo, or starting over?

        One thing I really like in user manuals is to have a section on configuring / setting preferences. So in your section outline, I’d probably call it

        • Preferences

        and put it after the Themes

        With highly configurable apps, like Notepad++, it’s often hard to remember where a given setting is, so having a single page which enumerates the location of each of the settings, as well as gives a brief description of each, would be quite useful.

        Other than that, I am sure as people contribute, new sections will be thought of. That outline is a great starting point. I look forward to contributing.

        Thank you.

        1 Reply Last reply Reply Quote 6
        • donho
          donho last edited by

          @PeterJones said:

          Is it going to be in the existing notepad-plus-plus/npp-usermanual repo, or starting over?

          Starting over. “notepad-plus-plus/npp-usermanual” repo will be removed.

          • Preferences

          Added now. Thanks.

          donho 1 Reply Last reply Reply Quote 4
          • donho
            donho @donho last edited by donho

            @PeterJones

            Is it going to be in the existing notepad-plus-plus/npp-usermanual repo, or starting over?

            Starting over. “notepad-plus-plus/npp-usermanual” repo will be removed.

            A little bit change:
            notepad-plus-plus/npp-usermanual is reloaded and it will be used as the Notepad++ document official repository:
            https://github.com/notepad-plus-plus/npp-usermanual/

            1 Reply Last reply Reply Quote 2
            • cmeriaux
              cmeriaux last edited by

              @donho
              What about using GitHub Page: GitHub Pages is designed to host your personal, organization, or project pages from a GitHub repository.
              Here is an example of my fork :
              https://cmeriaux.github.io/npp-usermanual/SUMMARY

              Meta Chuh 1 Reply Last reply Reply Quote 2
              • Meta Chuh
                Meta Chuh @cmeriaux last edited by Meta Chuh

                @cmeriaux

                many thanks for your thoughts, they are the same which we had at the beginning, of using github pages and the jekyll engine, due to the easy-cheesy setup.

                but currently we prefer to set up an in-house solution, that we can change to our needs anytime, without external dependencies.

                best regards

                1 Reply Last reply Reply Quote 1
                • donho
                  donho last edited by

                  It’s not so “in-house”. In fact we use Hugo (another popular MD to HTML generator) to render our document.
                  The “in house” part is each merge of PR into npp-usermanual master will update automatically the document site on the fly. So the document site in question cannot be in github.io if we want to have this feature.

                  Meta Chuh 1 Reply Last reply Reply Quote 3
                  • Meta Chuh
                    Meta Chuh @donho last edited by

                    @donho

                    each merge of PR into npp-usermanual master will update automatically the document site on the fly. So the document site in question cannot be in github.io if we want to have this feature.

                    the github pages jekyll engine renders all md files of a repo on the fly, that’s why we’ve first suggested it, to get the doc up and running as quickly as possible.

                    It’s not so “in-house”

                    yes, it’s not quite in-house, as long as we use the ovh server.
                    but as long as no-one sponsors a datacenter to notepad++ we will not be able to do everything in-house. 😉

                    1 Reply Last reply Reply Quote 2
                    • First post
                      Last post
                    Copyright © 2014 NodeBB Forums | Contributors