1

For example in a post I'm editing is the text:

I’m submitting a form post using Angularjs (1.2.20) to Microsoft ASP.Net MVC 4:

There are various ways I could format it (keep in mind the idea is that a real situation could have paragraphs worth of references to the same name):

  • None: maybe just standard English capitalization is good enough?:

    I’m submitting a form post using Angularjs (1.2.20) to Microsoft ASP.Net MVC 4:

  • Italic: seems too weak, and you don't want tons of italic everywhere:

    I’m submitting a form post using Angularjs (1.2.20) to Microsoft ASP.Net MVC 4:

  • Bold: seems maybe too strong, but this might be the way to go:

    I’m submitting a form post using Angularjs (1.2.20) to Microsoft ASP.Net MVC 4:

  • Inline Code: does not seem right

    I’m submitting a form post using Angularjs (1.2.20) to Microsoft ASP.Net MVC 4:

  • Tags: doesn't really work right and doesn't seem like this is intended

    I’m submitting a form post using (1.2.20) to :

3
  • 3
    FYI, the official way to capitalize the names of the two technologies is "AngularJS" and "Microsoft ASP.NET MVC 4" respectively.
    – BoltClock Mod
    Commented Jul 21, 2014 at 5:46
  • @BoltClock OCD nerds :P
    – user456814
    Commented Jul 21, 2014 at 5:49
  • 1
    NONE. If articles and text were full of random formatting - as they so often are around here - they would become very difficult to read. You don't need to highlight keywords. The human brain will pick out the important bits from a question anyway, if it's written in a clear and concise way.
    – J. Steen
    Commented Jul 21, 2014 at 6:26

2 Answers 2

11

This is what I think:

Italics

I’m submitting a form post using Angularjs (1.2.20) to Microsoft ASP.Net MVC 4:

In English publications, there is a convention that is sometimes used where cited works are italicized, like

  • The Wizard of Oz
  • The Avengers
  • Yellow Submarine

In the software industry, however, this is basically never done. So don't do it. It's annoying.

Bold

I’m submitting a form post using Angularjs (1.2.20) to Microsoft ASP.Net MVC 4:

I would avoid using bold to highlight the use of library names. If you feel that you have to emphasize library names with bold in your posts, then it's probably a sign that you're not writing clearly enough.

Inline code

I’m submitting a form post using Angularjs (1.2.20) to Microsoft ASP.Net MVC 4:

STOP USING CODE FORMATTING FOR THINGS THAT AREN'T CODE!!!

Y U USE CODE FORMATTING?!

Tags

I’m submitting a form post using (1.2.20) to :

I would avoid using tags to emphasize code libraries in what you write. Tags mess up the vertical spacing between lines, e.g. making it harder to read long posts. Plus, your post should already have tags in the tag section (if it's a question), so there's no need to add them to the post body.

Did I mention that tags, e.g. , mess up the vertical spacing between lines, making it harder to read long posts with many paragraphs? .

Summary

So basically, don't use any special formatting at all. If you feel like you need to emphasize the names of code libraries in your posts, then like I said earlier, it's probably a sign that you're not writing clearly enough, and you should work on improving the clarity of the post without having to resort to visually emphasizing library/framework names.

5
  • 1
    "it's probably a sign that you suck at writing clear posts" Ouch.
    – BoltClock Mod
    Commented Jul 21, 2014 at 5:45
  • @BoltClock toned it down.
    – user456814
    Commented Jul 21, 2014 at 5:48
  • 1
    I don't disagree but isn't this answer a little hypocritical?
    – Ben
    Commented Jul 21, 2014 at 5:53
  • 1
    @Ben too much bold?
    – user456814
    Commented Jul 21, 2014 at 5:56
  • 1
    Or italics....?
    – Ben
    Commented Jul 21, 2014 at 6:49
4

You don't need additional formatting. If you think you do, you're wrong. If you find yourself using multiple types of formatting for ordinary words your post is over-formatted. Don't use "standard English capitalisation" though; these are product names, capitalise them in the same way as the product.

If you're using a technology, put it in the tags, that's what they're there for. Only enumerate it again if you need to.

P.S. (I recognise you didn't want to) but people who use code highlighting for anything other than code are evil; like really naughty.

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .