|
Sponsored Links
Resources
Enterprise Java Research Library
Get Java white papers, product information, case studies and webcasts
|
News
News
News
|
Messages: 6
Messages: 6
Messages: 6
Printer friendly
Printer friendly
Printer friendly
Post reply
Post reply
Post reply
XML
XML
XML
|
 |
Tips on Writing News Posts, Reviews, Cartoons for TSS
I'd like to take a short bit to address writing news posts, articles, reviews, and cartoons. (I know: we haven't published a cartoon in a while, mostly because Your Humble Editor is an aural thinker, not a visual one, which means I can appreciate visual media, but can't contribute it. There's a long discussion possible here, but the first paragraph isn't the right place for that discussion, much less a parenthetical as long as this one.)
Writing content for TSS more effectively helps everyone – the readers and writers alike – and TSS is meant to be a community site. Your Humble Editor far prefers submitted content to content he scrums up, because he's only one person, and what's relevant to you – as a community – may be different than what's relevant to him (well, me, but I'm using third person here, bear with me.)
Let's talk about news posts first, since they're the easiest. Writing a news post is as simple as going to the home page of TSS, after logging in, and finding the link with the text "Post a News Item." (It's in disguise...)
There are a few wise rules to consider in a news post, though. There are three parts to the news post: title, summary, and content. (I'd like to end this paragraph with a parenthetical, since I ended all of the other ones with parentheticals too, but I didn't have one... oh, wait...)
Your title should be immediate and clear. It should refer to the news and what it means, for those few users who don't know. Thus, "XYZ released" is a terrible title – what's XYZ? Why do I care about it? Is this a major release, or a minor one? However, "XYZ 2.0, metaword library, released" makes more sense. (Provided, of course, "metaword" makes sense to you, and it doesn't to me.)
The summary is limited to 300 characters, and should be an expansion on the title. What's a metaword library for? The summary should tell me. It should tell me what changed in the release that makes the release relevant – so you might mention that XYZ now supports looking words up via RDF (which is, of course, the resource description framework, and you should provide handy links to things if summaries aren't good enough), so readers get quickly informed of what they need to know... leading to the newspost content. (Finally my useless parentheticals go... away... crud.)
The news post content follows the trend of more and more information. This is functionally unlimited, so go for broke: tell your readers where to find everything, what it is – really! - including code if you desire. Feel free to go into details. (Consider the body of this post, compared to the front page summary.)
The key here is to remember that you're writing for the web. Short sentences, short paragraphs rock. Long paragraphs... do not. They don't rock. Neither do long sentences.
Engage your readers. They don't really want to read this: your job is to keep them reading.
Don't be dumb. Your readers aren't; they don't need to read that your product is the whiz-bangiest doomaflatchie the world's ever seen. They just need to know what a doomaflatchie is, and what it's used for. Tell them. (One of Your Humble Editor's most common editing hackjobs is to strip out useless superlatives, which means "nearly all of them." I wish I could give out a prize to anyone who figures out what the rules are, but they're not that hard to figure out.)
Reviews are nearly the same as news posts, and are submitted the same way. In a review, I want to see what you really thought of the product; tell us your issues with it, how they were resolved (if at all), how the community responded, how much you paid for it (if you did), where you got it, what you used it for, what you really thought of it.
I – Your Humble Editor - really, really like reviews.
Most of them aren't very good, though, because the authors try to make them sound all review-y.
Don't do that. Write for yourself. It'll come through – and I'll fix everything I can.
The next type of submission is the cartoon. I wish I could do these; I enjoy them, but I'm afraid my sense of humor doesn't come through very well in the visual medium. (Meanwhile, the entire reading public said "We read visually, too...") That said, any cartoon ideas that come through, I'll consider strongly – and I really will try to make things happen.
Incidentally, the rules for preserving superlatives are: if they're deserved (i.e., I know the project is awesome) and if they're expressed as specifically personal opinion ("We think project X is a good implementation of...") Something that would get trimmed out is something that contributes nothing except fervor: "Product X is whoopsie-cow!"
What do you think?
|
|
Message #239602
Post reply
Post reply
Post reply
Go to top
Go to top
Go to top
|
 |
Addition
Joe, permit me to add a few tips:
1. Frame your topic around something controversial for MEGA-interest and MEGA-traffic. e.g. "Java is dying!", "RoR is better than your mom's apple pie!", "Gavin King bought a new pair of shoes!"
2. Prepare yourself to be flamed endlessly touting your new-fangled web-too-dot-ohh ayjacks eejaybee "framework" that you want to charge $2000 /CPU for.
3. Be nice to Joe. He will bury your future posts if you annoy him. ;-)
Hugs and kisses, Roy Russo http://www.loopfuse.com
|
|
Message #239604
Post reply
Post reply
Post reply
Go to top
Go to top
Go to top
|
 |
Re: Addition
Joe, permit me to add a few tips:
1. Frame your topic around something controversial for MEGA-interest and MEGA-traffic. e.g. "Java is dying!", "RoR is better than your mom's apple pie!", "Gavin King bought a new pair of shoes!"
2. Prepare yourself to be flamed endlessly touting your new-fangled web-too-dot-ohh ayjacks eejaybee "framework" that you want to charge $2000 /CPU for.
3. Be nice to Joe. He will bury your future posts if you annoy him. ;-)
Hugs and kisses, Roy Russo http://www.loopfuse.com Haha! Actually, I'm really glad you posted this - one thing I focused on was framing content, and I didn't focus much on the content to frame.
Actually, I tend to ignore flamebait without merit. Post "Java is dying" without anything for me to learn from it, and it gets buried. If there's something there to learn from, I will consider it.
I don't care about commercial v. noncommercial stuff. That's not my bag, honestly. I use open source (and write it) as well as commercial software (and I write that, too!) I don't have an ethical problem with someone trying to see what the market will bear. At the same time, I'm happy to point out things that I think are successful, so others can be successful as well.
Being nice to me... bah, like I'm small-minded enough to care! Sheesh, Ted Neward suggested in a Tech Talk that I work in fast food... and I thought that talk was great. :)
OTOH, I do have to admit, posts by anyone whose last name is "Russo..." they get tanked. :)
|
|
Message #239610
Post reply
Post reply
Post reply
Go to top
Go to top
Go to top
|
 |
Re: Addition
Frame your topic around something controversial for MEGA-interest and MEGA-traffic. e.g. "Java is dying!", "RoR is better than your mom's apple pie!"
Nope, not me. I've *never* done that before :D :D :D
-John Mark Hyperic Community Manager http://www.hyperic.com/
|
|
Message #243213
Post reply
Post reply
Post reply
Go to top
Go to top
Go to top
|
 |
Re: Tips on Writing News Posts, Reviews, Cartoons for TSS
I will try these Tips and give more attention to Short sentences and description Thank You for the article very informatic information
|
|
 |
New content on TheServerSide.comNew content on TheServerSide.comNew content on TheServerSide.com |
 |
 |
Reza Rahman explores the features of the proposed JSR 299, Contexts and Dependency Injection for Java EE (CDI). When approved, it promises to be a key feature of Java EE 6.
(November 2, Article)
SAML is an XML-based standard for exchanging authentication and authorization data between security domains. The single most important problem that SAML was created to solve is the Web browser Single Sign-On problem. Many organizations are debating whether to stay with version 1.1 or move to 2.0. This article makes observations about both options.
(September 28, Article)
Joe Ottinger takes a look at how people learn, and applies it to the practice of programming. He notes that understanding how people learn is an essential part of working in a programming team.
(September 22, Article)
Stephen Maryka gave us an article about the Asynchronous Web and posed a number of questions that get examined like an approach to delivering Asynchronous Web capabilities through extensions to existing Java EE technologies.
(July 14, Article)
JavaServer Faces Flex goal is to provide users capability in creating standard Flex components, part of flexSDK which is open sourced through MPL license, as normal JSF components. This article by Ji Hoon Kim will provide an overview of creating a simple multilingual JSF page consisting of JSF Flex tags.
(June 29, Article)
In this session Jeff explores the key characteristics of successful SOA projects. He covers some of the patterns, and anti-patterns, tool sets, and strategies that he himself learned the hard way. Last, he provides a strategy and blueprint for achieving a high likelihood of success in your SOA project.
(June 23, Tech Talk)
Ari Zilka, CTO of Terracotta, Inc., talks about the new features in Terracotta 3.1, announced during JavaOne and available now.
(June 15, Tech Talk)
In this Tech Talk, Josh Long explores an integration challenge using Spring Integration and walks through the implementation, employing and expanding on the basic patterns of Enterprise Application Integration to tie together components into a function integration solution, and then demonstrates how Spring Integration helps address the integration requirements.
(June 15, Tech Talk)
In this Tech Talk, David Geary teaches you: The basics of Google Web Toolkit; How to implement Ajax-enabled applications in Java; Internationalization; Hooking into the browser history mechanism; Remote procedure calls.
(June 4, Tech Talk)
Jon Kern discusses the best architecture/technical solutions and ensure that they are repeated by all developers. By tackling the architecture up-front in a serial manner, subsequent parallel development will be much more manageable and predictable.
(May 28, Tech Talk)
This keynote describes the frustrations of modern knowledge workers in their quest to actually get some work done, and solutions for how to guard yourself against all those distractions. Neal Ford talks about environments, coding, acceleration, automation, and avoiding repetition as ways to defeat the misguided attempts to sap your ability to produce good work.
(May 26, Tech Talk)
Gil demonstrates how new, aggressive uses of already abundant compute capacity by common applications offer competitive value for application designers.
(May 21, Tech Talk)
Chris Keene introduces WaveMaker as a new way to automate the ability to generate Hibernate classes in order to more quickly bring OR mapping into an application.
(May 19, Article)
In this session Nati Shalom demonstrates how to take a standard Java EE web application and scale it out or down dynamically without changes to the application code. Seeing as most web applications are over-provisioned to meet infrequent peak loads, this is a dramatic change because it enables growing your application as needed, when needed, without paying for unutilized resources.
(May 19, Tech Talk)
Mastering EJB was one of the original and most influential EJB books in the industry. Mastering EJB III now returns with two new expert co-authors, updated for EJB 2.1 and 30% new chapters including security, integration, best practices, open source, and more.
(Book PDF Download)
The Application Server Matrix is a detailed listing of J2EE vendors and their application server products, with information on latest version numbers, J2EE spec support and licensing, pricing, platform support, and links to product downloads and reviews.
(Application Server Comparison Matrix)
|
|