Click here to Skip to main content
15,891,909 members

Welcome to the Lounge

   

For discussing anything related to a software developer's life but is not for programming questions. Got a programming question?

The Lounge is rated Safe For Work. If you're about to post something inappropriate for a shared office environment, then don't post it. No ads, no abuse, and no programming questions. Trolling, (political, climate, religious or whatever) will result in your account being removed.

 
GeneralRe: Maybe a first article from my side - unsure how to do it - tips appreciated Pin
OriginalGriff2-Apr-17 2:28
mveOriginalGriff2-Apr-17 2:28 
GeneralRe: Maybe a first article from my side - unsure how to do it - tips appreciated Pin
User 110609792-Apr-17 3:10
User 110609792-Apr-17 3:10 
GeneralRe: Maybe a first article from my side - unsure how to do it - tips appreciated Pin
OriginalGriff2-Apr-17 3:49
mveOriginalGriff2-Apr-17 3:49 
GeneralRe: Maybe a first article from my side - unsure how to do it - tips appreciated Pin
OriginalGriff1-Apr-17 6:28
mveOriginalGriff1-Apr-17 6:28 
GeneralRe: Maybe a first article from my side - unsure how to do it - tips appreciated Pin
Brady Kelly3-Apr-17 8:37
Brady Kelly3-Apr-17 8:37 
GeneralRe: Maybe a first article from my side - unsure how to do it - tips appreciated Pin
OriginalGriff3-Apr-17 8:42
mveOriginalGriff3-Apr-17 8:42 
GeneralRe: Maybe a first article from my side - unsure how to do it - tips appreciated Pin
Mark_Wallace4-Apr-17 3:57
Mark_Wallace4-Apr-17 3:57 
GeneralRe: Maybe a first article from my side - unsure how to do it - tips appreciated PinPopular
Marc Clifton1-Apr-17 7:28
mvaMarc Clifton1-Apr-17 7:28 
0x01AA wrote:
How you would structure this?


Start with everything you want to talk about, put it into an outline of topics/sub-topics.

Start writing either linearly or the parts that you're drawn to first.

As you're writing, update the outline and see how things begin to evolve -- is it getting too long, is there a natural break for a couple articles evolving? Prune stuff that becomes irrelevant or you don't want to deal with.

0x01AA wrote:
Should I use the online editor


No - although it's evolved a lot, like being able to save drafts, I find online editing of anything to be a PITA, with the exception of lounge posts, haha. I'm an old fart, so believe it or not, I'm still using FrontPage 2003 for editing. Find a decent HTML editor (harder than it looks, maybe someone can make some recommendations here) that can let you do a split screen of the markup and the WYSIWYG. Write it all offline.

Hint to save you pain: images go in the same folder as wherever your "article.html" is, as image references in CP are now (and have been for quite a while, but it was not always so) "local".

Other hints:
  • Main topic headers are H2
  • Use bold and italic sparingly
  • variable names, methods, etc., in the text should be wrapped with code tags
  • code blocks are wrapped in pre tags
  • watch your image size, CP likes images no bigger than, um, 600 width (I think) which I violate constantly. One cool technique for really big images is to put upload both a small and a 100% image, and add a link to the 100% image, like "click here for full size image."
  • Personally, I like small code blocks. Don't throw a 500 line class at me, break it into individual method code blocks, in between explain what each method does and why (why is sooo important), etc.
More hints: A Guide To Writing Articles For Code Project

Something I've seen people start doing which I really like is a section at the top of the article on "what you will learn", which is cool, because even if I have no interest in a C-like <1% parser, I might be really interested in how EBNF works and other cool geeky things you are covering.

Marc
Latest Article - Merkle Trees

Learning to code with python is like learning to swim with those little arm floaties. It gives you undeserved confidence and will eventually drown you. - DangerBunny

Artificial intelligence is the only remedy for natural stupidity. - CDP1802

GeneralRe: Maybe a first article from my side - unsure how to do it - tips appreciated Pin
Jörgen Andersson1-Apr-17 7:44
professionalJörgen Andersson1-Apr-17 7:44 
GeneralRe: Maybe a first article from my side - unsure how to do it - tips appreciated Pin
OriginalGriff1-Apr-17 8:13
mveOriginalGriff1-Apr-17 8:13 
GeneralRe: Maybe a first article from my side - unsure how to do it - tips appreciated Pin
Jörgen Andersson1-Apr-17 8:29
professionalJörgen Andersson1-Apr-17 8:29 
GeneralRe: Maybe a first article from my side - unsure how to do it - tips appreciated Pin
User 110609791-Apr-17 8:49
User 110609791-Apr-17 8:49 
GeneralRe: Maybe a first article from my side - unsure how to do it - tips appreciated Pin
User 110609792-Apr-17 1:24
User 110609792-Apr-17 1:24 
GeneralRe: Maybe a first article from my side - unsure how to do it - tips appreciated Pin
Marc Clifton2-Apr-17 3:06
mvaMarc Clifton2-Apr-17 3:06 
GeneralRe: Maybe a first article from my side - unsure how to do it - tips appreciated Pin
User 110609792-Apr-17 4:20
User 110609792-Apr-17 4:20 
GeneralRe: Maybe a first article from my side - unsure how to do it - tips appreciated Pin
Marc Clifton2-Apr-17 10:47
mvaMarc Clifton2-Apr-17 10:47 
GeneralRe: Maybe a first article from my side - unsure how to do it - tips appreciated Pin
jediYL3-Apr-17 13:25
professionaljediYL3-Apr-17 13:25 
GeneralRe: Maybe a first article from my side - unsure how to do it - tips appreciated Pin
User 110609793-Apr-17 20:21
User 110609793-Apr-17 20:21 
GeneralHow did the hipster burn his mouth? Pin
OriginalGriff1-Apr-17 5:20
mveOriginalGriff1-Apr-17 5:20 
GeneralRe: How did the hipster burn his mouth? Pin
Daniel Pfeffer1-Apr-17 6:56
professionalDaniel Pfeffer1-Apr-17 6:56 
GeneralRe: How did the hipster burn his mouth? Pin
Rick York2-Apr-17 13:11
mveRick York2-Apr-17 13:11 
JokeBut I wanna be exclusive! Pin
Cornelius Henning1-Apr-17 1:59
professionalCornelius Henning1-Apr-17 1:59 
GeneralRe: But I wanna be exclusive! Pin
CDP18021-Apr-17 3:05
CDP18021-Apr-17 3:05 
GeneralRe: But I wanna be exclusive! Pin
DaveAuld1-Apr-17 3:33
professionalDaveAuld1-Apr-17 3:33 
GeneralRe: But I wanna be exclusive! Pin
OriginalGriff1-Apr-17 3:59
mveOriginalGriff1-Apr-17 3:59 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.