ML
    • Recent
    • Categories
    • Tags
    • Popular
    • Users
    • Groups
    • Register
    • Login

    IT Documentation

    Scheduled Pinned Locked Moved IT Discussion
    networkingdocumentationservers
    12 Posts 5 Posters 3.0k 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.
    • Reid CooperR
      Reid Cooper @A Former User
      last edited by

      @thecreativeone91 said:

      IS this a huge red flag or is it just normal?

      Red flag.

      1 Reply Last reply Reply Quote 0
      • Minion QueenM
        Minion Queen
        last edited by

        As a manager: RED FLAG!! The how to's should already be known for anyone who would be reading the documentation. The why's and gotchya's are what you should document.

        Reid CooperR 1 Reply Last reply Reply Quote 1
        • Reid CooperR
          Reid Cooper @Minion Queen
          last edited by

          @Minion-Queen Or be easy to look up.

          One of the reasons that How Tos that are public are important is that they get well tested by people using them over and over again. Any gotchas are normally found by other people. Internal documentation of standard processes is just asking for errors or missing pieces.

          1 Reply Last reply Reply Quote 0
          • ?
            A Former User
            last edited by

            That's kinda what I figured. I think it's pointless to redo someone else work.

            Aside from the fact that he's a systems administrator so he kinda should be able to figure it out.

            scottalanmillerS 1 Reply Last reply Reply Quote 0
            • scottalanmillerS
              scottalanmiller @A Former User
              last edited by

              @thecreativeone91 said:

              That's kinda what I figured. I think it's pointless to redo someone else work.

              Aside from the fact that he's a systems administrator so he kinda should be able to figure it out.

              Or even know it already.

              ? 1 Reply Last reply Reply Quote 0
              • Bill KindleB
                Bill Kindle
                last edited by

                So the boss is a plagiarist? Yeah, that wouldn't sit well with me either. That's also a huge red flag and I agree with the above sentiments already stated.

                1 Reply Last reply Reply Quote 0
                • ?
                  A Former User @scottalanmiller
                  last edited by A Former User

                  @scottalanmiller said:

                  Or even know it already.

                  Exactly I think being a systems administrator you should be able to figure out how to do this stuff pretty easily without this. But he needs it, mainly because he doesn't know anything technical.

                  Here's an example of how simple he needs the how-to's. Well, he might have not needed the [Web browser made a link to this page] (http://en.wikipedia.org/wiki/Web_browser) But before I made the login how to and just told him to use the IP in a browser he couldn't figure it out, so I figured I would cover all bases. I still haven't made one for the core switch witch are CLI based catalyst switches so I'm not sure how to do that, and be simple. these are our SG200 switch which are the access switches.
                  Switches.tiff

                  And this is another one.
                  copyrunning conifg.tiff

                  Bill KindleB 1 Reply Last reply Reply Quote 0
                  • Reid CooperR
                    Reid Cooper
                    last edited by

                    Yes, none of it sounds good. Let's highlight:

                    • He doesn't know how to do his job.
                    • He doesn't know how documentation should work.
                    • He takes credit for other people to cover up not being able to do his job.
                    • He has been in this one job more than long enough to know this stuff - all stuff that he should have known when he was first hired, so after nine years he is not yet up to the level he should have been to be hired!!!

                    In reality, it is HIS managers that are probably causing the problem.

                    1 Reply Last reply Reply Quote 2
                    • Bill KindleB
                      Bill Kindle @A Former User
                      last edited by

                      @thecreativeone91 said:

                      think being a systems administrator you should be able to figure out how to do this stuff pretty easily without this. But he needs it, mainly because he doesn't know anything technical.

                      Yeah I would refuse to create this type of documentation. Why? It's already been done. I would hand the boss the PDF guides, point out the exact pages he needs and say finished.

                      1 Reply Last reply Reply Quote 2
                      • scottalanmillerS
                        scottalanmiller
                        last edited by

                        Always good to check with upper management.

                        "Hey boss' boss, just wanted to run this by you. My boss needs me to document trivial IT tasks that the intern (that we don't have) should be able to look up without a problem and spend time and company money maintaining them so that he, not I, can repeatedly do entry level tasks without needing to get assistance from elsewhere. I'm happy to do this but this puts us at risk of the documentation being wrong since I am just making copies of the industry or vendor documentation, and because it is impossible to keep every internal doc continuously in sync with the latest vendor changes, guidelines and best practices. Just wanted to make sure that you agree that making this kind of documentation, all for one person, is a good use of government financial resources?"

                        1 Reply Last reply Reply Quote 1
                        • 1 / 1
                        • First post
                          Last post