Skip to content
  • Categories
  • Recent
  • Tags
  • Popular
  • World
  • Users
  • Groups
Skins
  • Light
  • Cerulean
  • Cosmo
  • Flatly
  • Journal
  • Litera
  • Lumen
  • Lux
  • Materia
  • Minty
  • Morph
  • Pulse
  • Sandstone
  • Simplex
  • Sketchy
  • Spacelab
  • United
  • Yeti
  • Zephyr
  • Dark
  • Cyborg
  • Darkly
  • Quartz
  • Slate
  • Solar
  • Superhero
  • Vapor

  • Default (No Skin)
  • No Skin
Collapse
Code Project
  1. Home
  2. The Lounge
  3. A matter of style

A matter of style

Scheduled Pinned Locked Moved The Lounge
salesquestion
45 Posts 33 Posters 0 Views 1 Watching
  • 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.
  • S snowlin

    As a technical writer in a company that didn't have one before, I had to come with our company "style". I referenced a lot of the Chicago Manual of Style and Microsoft Manual of Style v3. The latter more so because we are a Certified Microsoft Gold Partner shop. I go with the colon. And our programmers follow the same suit. The reason: there should be a visual separation between a label and it's value. A colon by definition is a division, or a separation, indicating there is more to follow.

    S.Nowlin ----------------------- I'm a Techwriter Monkey -- handy, just less useful than the Bathroom Monkey.

    N Offline
    N Offline
    Not Active
    wrote on last edited by
    #41

    Awesome. I knew about the UI guidelines but didn't know about the style manual. Good reference for these situations


    only two letters away from being an asset

    S 1 Reply Last reply
    0
    • N Not Active

      Awesome. I knew about the UI guidelines but didn't know about the style manual. Good reference for these situations


      only two letters away from being an asset

      S Offline
      S Offline
      snowlin
      wrote on last edited by
      #42

      The style manuals, and there are several out there, have been life savers as far as justifying a visual style standard, or a grammatical standard, that I've implemented. I still get vetoed, but at least when, 6 mos or a year from now, someone says "Why did we make that change?", or "Why are we doing this, it's stupid." I can point to my documented recommendation and say "It wasn't me!" :cool:

      S.Nowlin ----------------------- I'm a Techwriter Monkey -- handy, just less useful than the Bathroom Monkey.

      1 Reply Last reply
      0
      • N Not Active

        So whats the consensus around here? When creating an app do you place a colon after your labels or not? i.e. Customer Name: [label] or Customer Name [label] I've always used a colon but have recently been told by our CIO to not use them. I think it just makes everything bleed together and looks terrible.


        only two letters away from being an asset

        S Offline
        S Offline
        Snowman58
        wrote on last edited by
        #43

        There was a recent article on the web that said the most readable style was to put the label above the data entry box. If I can find the reference I will add it. Is the CIO the boss? If so, just leave out the colons & don't worry about it. Life's too short to try & convince him of the correctness or lack thereof of style. For all you know you are both working for a NO COLON freak who would have you fired for using them. Personally I don't like colons - but then I am my own boss & I (usually) get to decide!

        1 Reply Last reply
        0
        • J JudyL_MD

          jgasm wrote:

          sorry?

          Requires knowledge of english slang. It's a play on words regarding human anatomy. The intenstinal tract contains a "colon" so ... how can you "go" (euphemism for venting bodily wastes) if you don't use a colon Judy

          B Offline
          B Offline
          BoneSoft
          wrote on last edited by
          #44

          C:[ENTER]###


          Visit BoneSoft.com for code generation tools (XML & XSD -> C#, VB, etc...) and some free developer tools as well.

          1 Reply Last reply
          0
          • N Not Active

            So whats the consensus around here? When creating an app do you place a colon after your labels or not? i.e. Customer Name: [label] or Customer Name [label] I've always used a colon but have recently been told by our CIO to not use them. I think it just makes everything bleed together and looks terrible.


            only two letters away from being an asset

            D Offline
            D Offline
            DrFrankenstein90
            wrote on last edited by
            #45

            I do. Just... makes sense.

            1 Reply Last reply
            0
            Reply
            • Reply as topic
            Log in to reply
            • Oldest to Newest
            • Newest to Oldest
            • Most Votes


            • Login

            • Don't have an account? Register

            • Login or register to search.
            • First post
              Last post
            0
            • Categories
            • Recent
            • Tags
            • Popular
            • World
            • Users
            • Groups