Netgate Discussion Forum
    • Categories
    • Recent
    • Tags
    • Popular
    • Users
    • Search
    • Register
    • Login

    Where is the documentation?

    Scheduled Pinned Locked Moved General pfSense Questions
    56 Posts 15 Posters 13.1k Views
    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.
    • jimpJ Offline
      jimp Rebel Alliance Developer Netgate
      last edited by

      You can expect the documentation to get even better as time goes on, as we get bigger and bring on more personnel and have more time to focus on documentation once we're not all constantly overloaded providing support. It's an ongoing never-ending process. It's good enough for most, but there will always be gaps. Especially in troubleshooting since it's very unpredictable.

      Remember: Upvote with the 👍 button for any user/post you find to be helpful, informative, or deserving of recognition!

      Need help fast? Netgate Global Support!

      Do not Chat/PM for help!

      1 Reply Last reply Reply Quote 0
      • KOMK Offline
        KOM
        last edited by

        Yeah… You've got a great community here. On top of having little in the way of documentation for the current version of the product, plenty of people to tell a potential user that they don't know what they're talking about, don't have a clue, and then start calling them names. Kudos to not just the members, but the admins that allow (and dare I say even encourage?) this sort of behavior.

        There is a saying… "If you run into a jerk in the morning, well he was just a jerk.  If you run into jerks all day long, you're the jerk."

        You came storming into the forum with nothing but complaints.  The people here help others free of charge on their own time, and you managed to pretty much alienate all of us with your attitude.  The admins here have been nothing but nice to you, but others are responsible for their own comments.  You don't take any responsibility for your end in this unfortunate exchange.  You have a chip on your shoulder and I don't see how that helps you get ahead.

        Considering how all the docs are poor, the product itself is inscrutable and the forum members are hostile snobs, I wouldn't expect to see you still around.

        1 Reply Last reply Reply Quote 0
        • E Offline
          ember1205
          last edited by

          Yep. All my fault. Got it.

          Guess the posts that I put before this one and all of the direct forum searches and searches via Google don't really matter.

          Hey, Admins…kill my account. I won't bother returning.

          1 Reply Last reply Reply Quote 0
          • H Offline
            heper
            last edited by

            yes oddly enough your first post 5 days ago (https://forum.pfsense.org/index.php?topic=83065.msg454681#msg454681), only got 5 replies with suggestions.
            then you decided not to continue that thread.

            then you started this thread to blame the entire community, for having crappy documentation.

            then you are surprised that you are being called a troll.

            sorry for

            1 Reply Last reply Reply Quote 0
            • R Offline
              riahc3 Banned
              last edited by

              There is something I would wish for:

              I wish there was a automatic server that builds a PDF of the https://doc.pfsense.org site.

              This way you can have a more or less up to date offline documentation of pfSense available to download whenever you want.

              1 Reply Last reply Reply Quote 0
              • stephenw10S Offline
                stephenw10 Netgate Administrator
                last edited by

                Interesting suggestion. I bet there's a 'wiki downloader' of something similar that would do it, probably better. It might even be syncable.

                Steve

                1 Reply Last reply Reply Quote 0
                • A Offline
                  aGeekhere
                  last edited by

                  Would this do ? http://www.httrack.com/

                  Never Fear, A Geek is Here!

                  1 Reply Last reply Reply Quote 0
                  • R Offline
                    riahc3 Banned
                    last edited by

                    @aGeekHere:

                    Would this do ? http://www.httrack.com/

                    No. This just downloads a website which wget can do.

                    Something fully automated by a server that makes a organized PDF document on the fly.

                    1 Reply Last reply Reply Quote 0
                    • stephenw10S Offline
                      stephenw10 Netgate Administrator
                      last edited by

                      It's the sort of thing I would expect to exist but a quick google doesn't show much that's promising. The search gets bogged down by code to download the whole of wikipedia though.  ::)

                      Steve

                      1 Reply Last reply Reply Quote 0
                      • R Offline
                        riahc3 Banned
                        last edited by

                        @stephenw10:

                        It's the sort of thing I would expect to exist but a quick google doesn't show much that's promising. The search gets bogged down by code to download the whole of wikipedia though.  ::)

                        Steve

                        Sadly, I think it would have to be created inhouse by pfSense. And its not that easy to implement.

                        1 Reply Last reply Reply Quote 0
                        • jimpJ Offline
                          jimp Rebel Alliance Developer Netgate
                          last edited by

                          There are mediawiki plugins to generate such a document on the server side, though I'm not sure if it would be a good idea to implement or not. People might mistake that for the actual book. Not to mention it would take quite a bit of space/cpu time to generate.

                          Remember: Upvote with the 👍 button for any user/post you find to be helpful, informative, or deserving of recognition!

                          Need help fast? Netgate Global Support!

                          Do not Chat/PM for help!

                          1 Reply Last reply Reply Quote 0
                          • GruensFroeschliG Offline
                            GruensFroeschli
                            last edited by

                            I've played quite a lot with mediawiki to pdf exporters.
                            My conclusion is that none are satisfying. You always get a lot of mis-formatted stuff.

                            We do what we must, because we can.

                            Asking questions the smart way: http://www.catb.org/esr/faqs/smart-questions.html

                            1 Reply Last reply Reply Quote 0
                            • stephenw10S Offline
                              stephenw10 Netgate Administrator
                              last edited by

                              Better than nothing when you just hosed your pfSense install and have no internet connection?

                              Steve

                              1 Reply Last reply Reply Quote 0
                              • A Offline
                                aGeekhere
                                last edited by

                                Then you could have an offline copy of pfsense and even the forum using httrack ?

                                Never Fear, A Geek is Here!

                                1 Reply Last reply Reply Quote 0
                                • First post
                                  Last post
                                Copyright 2025 Rubicon Communications LLC (Netgate). All rights reserved.