UnThreaded | Threaded | Whole Thread (11) | Ignore Thread Prev Thread | Next Thread
Author: havefunsaving Big red star, 1000 posts Old School Fool Ticker Guide Add to my Favorite Fools Ignore this person (you won't see their posts anymore) Number: of 597  
Subject: Formatting thoughts Date: 8/27/2008 4:12 AM
Post New | Post Reply | Reply Later | Create Poll Report this Post | Recommend it!
Recommendations: 2
I have a question on the consensus for formatting within the Flossary pages.

When I read a page with multiple "boldings" of that page's term (and/or every time a "linked" word is used, it is... well, linked), it can get a bit irritating. Does anyone else feel this way?

I was thinking that perhaps we could just "bold" the first mention of a page's term within the "quick definition" and then the "expanded definition." After that, it could just be typed as a regular word, since it has already been boldy referenced once. Same with links to other terms within the definition. Link it once, then just type it in regular typeface.

Sort of how it's done in the WSJ. Once they have bolded a company's name within an article, it is in regular typeface thereafter.

I have changed this to my liking on a couple of pages, but then thought that it is such a major formatting "guideline" that it should be voted on by consensus.

In the same vein, I think we should consider not capitalizing the term throughout the page. What say y'all? I'm thinking that if the term would not normally be capitalized within an unrelated article, it shouldn't be capitalized throughout our article.

Agree? Disagree?

And kindly note: For anyone who has done any or all of the above, my intention is not to pick on you or "red-line" your work. However, I do think it is a valid topic for discussion that we should consider as editors, for the betterment of the Flossary pages -- whichever way the consensus goes.

Best regards,
Kathie
Post New | Post Reply | Reply Later | Create Poll Report this Post | Recommend it!
Print the post Back To Top
Author: pllntooz Big red star, 1000 posts Ticker Guide CAPS All Star Add to my Favorite Fools Ignore this person (you won't see their posts anymore) Number: 258 of 597
Subject: Re: Formatting thoughts Date: 8/27/2008 6:48 AM
Post New | Post Reply | Reply Later | Create Poll Report this Post | Recommend it!
Recommendations: 0
Hi Kathie,

I think the linked words are automatically created by the Wiki. MediaWiki (the software behind Flossary if I'm not mistaken) automatically creates links to words it recognizes as pages within the Wiki.

I could be wrong, in which case, it certainly seems like reduced effort to only create a link for something once.

Another possiblity is to have a section at the bottom of the pages for references and/or links where all links are listed.

Foolishy,
Paul

Print the post Back To Top
Author: TMFGebinr Big gold star, 5000 posts Old School Fool Supernova Phoenix 1
Mission Team Member CAPS All Star SC1 Red Add to my Favorite Fools Ignore this person (you won't see their posts anymore) Number: 259 of 597
Subject: Re: Formatting thoughts Date: 8/27/2008 9:08 AM
Post New | Post Reply | Reply Later | Create Poll Report this Post | Recommend it!
Recommendations: 1
Hi Kathie and Paul,

The software does not automatically create links for recognized words, we have to do that with the double hard brackets.

The format I like and which we started with is bold the word or phrase the first time in the quick definition and then leave it as normal font every other time it's used. Wiki links don't have to be bold as they'll appear as a different color automatically.

Cheers,
Jim

Print the post Back To Top
Author: TMFMoby Two stars, 250 posts Old School Fool CAPS All Star Add to my Favorite Fools Ignore this person (you won't see their posts anymore) Number: 268 of 597
Subject: Re: Formatting thoughts Date: 8/27/2008 11:48 AM
Post New | Post Reply | Reply Later | Create Poll Report this Post | Recommend it!
Recommendations: 0
consensus for formatting within the Flossary pages.
Excellent discussion! Thanks for starting it Kathie.

I agree with Jim. Bold the first instance of the page name in the article. This should be in the quick definition. After that, there's no need to bold it. Same deal with linking related terms. After the first instance of the term, don't worry about linking it a second time. This is what Fool.com does in article when we mention company names and tickers.

I think we should consider not capitalizing the term throughout the page.
Agree entirely. Capitalize as you would normally if you were writing an article or a board post.

And kindly note: For anyone who has done any or all of the above, my intention is not to pick on you or "red-line" your work
Don't worry about this disclaimer. It is very Foolish to start discussions such as these. I hope every editor feels empowered to question things, and I also hope no editor will take offense to a polite discussion or talking-point such as this one, even if that editor has been doing that exact thing.

As long as the intent is to improve the resource we're building together, then no-one should take issue with suggestions or questions, even if it's a 180 from what they've been doing.

Jeremy

Print the post Back To Top
Author: havefunsaving Big red star, 1000 posts Old School Fool Ticker Guide Add to my Favorite Fools Ignore this person (you won't see their posts anymore) Number: 273 of 597
Subject: Re: Formatting thoughts Date: 8/27/2008 4:24 PM
Post New | Post Reply | Reply Later | Create Poll Report this Post | Recommend it!
Recommendations: 1
As long as the intent is to improve the resource we're building together, then no-one should take issue with suggestions or questions, even if it's a 180 from what they've been doing.

Jeremy


Agreed. However, we are human beings (well, most of us, anyway) -- and humans are subject to "stuff."

Having been an editor, perhaps I am a tad sensitive as to how others perceive my "help." (Not that that has ever stopped me.) Just wanted to avert a mass lynching-party. :o)

And we have new folks joining who may or may not be familiar with editing of their posts.

So here is my take on it: As an editor of Flossary, I will edit my own and others' pages in the perception that my edits will make it more accurate/readable/objective/whatever/take-your-pick. I expect others to do the same with my posts and/or edits.

If I change something, and another person changes it back to the original, I will likely email that person with my thoughts on why I think mine is the better version. If I convince you to my way of thinking, wonderful! If not, then...

Off with their heads! (bwa-ha-ha-ha)

Just so we're clear. I'm a really sweet and wonderful person. Really. Honest. Trust me on this.

But the editor in me can be merciless, when in search of excellence.

Best regards,
Kathie

Print the post Back To Top
Author: Tastylunch Three stars, 500 posts Feste Award Nominee! Add to my Favorite Fools Ignore this person (you won't see their posts anymore) Number: 278 of 597
Subject: Re: Formatting thoughts Date: 8/27/2008 6:36 PM
Post New | Post Reply | Reply Later | Create Poll Report this Post | Recommend it!
Recommendations: 0
Ah whoops I'm one of the (if not the) likely offender(s) here. I'll go fix my incorrect usages that I can find that still remain.

I must have missed these guidelines when I read the styleguide. Ah the problem of having 60 tabs open in Firefox at the same time.

Sorry about that, I'll endeavor to better in the future.

Print the post Back To Top
Author: Fuskie Big funky green star, 20000 posts Top Favorite Fools Old School Fool Ticker Guide SC1 Red Winner of the 2010 Rule Breakers Challenge Add to my Favorite Fools Ignore this person (you won't see their posts anymore) Number: 279 of 597
Subject: Re: Formatting thoughts Date: 8/28/2008 12:58 AM
Post New | Post Reply | Reply Later | Create Poll Report this Post | Recommend it!
Recommendations: 3
I think if we want format standards, we should create a format guideline FAQ and have it placed in the Announcements column to the right and added to the Getting Started page.

Fuskie
Who is now starting to second guess his own formatting choices...

Print the post Back To Top
Author: havefunsaving Big red star, 1000 posts Old School Fool Ticker Guide Add to my Favorite Fools Ignore this person (you won't see their posts anymore) Number: 280 of 597
Subject: Re: Formatting thoughts Date: 8/28/2008 1:59 AM
Post New | Post Reply | Reply Later | Create Poll Report this Post | Recommend it!
Recommendations: 2
I think if we want format standards, we should create a format guideline FAQ and have it placed in the Announcements column to the right and added to the Getting Started page.

Here's where a goodly portion of the info can be found:

http://wiki.fool.com/wiki/Help:Styleguide
http://wiki.fool.com/wiki/Help:Formatting

Had I remembered to go review those pages, I could have saved myself posting the question in the first place. (Although a little clarification never hurts, I suppose.)

One of the things I am finding that is unfortunate as I age, is that without proper sleep, my mind just simply doesn't function as well as I wish it would. I "forget" stuff I already knew, or forget that I've forgotten that I knew it... do you see a pattern developing here?

Also note: You can even edit the "Help" pages for all of us here on Flossary! When I first started, I didn't understand how to type the multiple quotation marks around words/phrases to get the desired effect (either formatting for italics or bold). So I went in and edited that section on the formatting page to clarify it for others who might not be up-to-speed on such things.

The entire wiki, more or less, is subject to change, refinement, clarifying... in other words, we have the freedom to make it as fabulous as we possibly can. For both ourselves and ultimately, the general public.

So, if you see a need that has not been addressed... consider addressing it! I tell you, the power engendered can make one positively giddy. (lol)

Best regards,
Kathie

Post New | Post Reply | Reply Later | Create Poll Report this Post | Recommend it!
Print the post Back To Top
Author: TMFBiologyFool Three stars, 500 posts CAPS All Star Add to my Favorite Fools Ignore this person (you won't see their posts anymore) Number: 281 of 597
Subject: Re: Formatting thoughts Date: 8/28/2008 2:05 AM
Post New | Post Reply | Reply Later | Create Poll Report this Post | Recommend it!
Recommendations: 2
I think if we want format standards, we should create a format guideline FAQ and have it placed in the Announcements column to the right and added to the Getting Started page.

It's in the help section:
http://wiki.fool.com/wiki/Category:Help_pages
Specifically:
http://wiki.fool.com/wiki/Help:Styleguide

Note also that you can edit the help pages so feel free to put a link to the style guide on the getting started page - a great suggestion, by the way, as I started writing before I found the style guide.

-Brian

Print the post Back To Top
Author: TMFBiologyFool Three stars, 500 posts CAPS All Star Add to my Favorite Fools Ignore this person (you won't see their posts anymore) Number: 282 of 597
Subject: Re: Formatting thoughts Date: 8/28/2008 2:10 AM
Post New | Post Reply | Reply Later | Create Poll Report this Post | Recommend it!
Recommendations: 0
Yeah, what Kathie said (funny how we even mentioned editing help pages). Apparently it took me at least 6 min to find the page and proof read my post as I'd swear Kathie's answer wasn't there when I started.

-Brian

Print the post Back To Top
Author: havefunsaving Big red star, 1000 posts Old School Fool Ticker Guide Add to my Favorite Fools Ignore this person (you won't see their posts anymore) Number: 283 of 597
Subject: Re: Formatting thoughts Date: 8/28/2008 2:53 AM
Post New | Post Reply | Reply Later | Create Poll Report this Post | Recommend it!
Recommendations: 0
...as I'd swear Kathie's answer wasn't there when I started.

No, it wasn't. At least, I suspect, not when you started writing your post. (It's amazing how time flies when you're constructing a post/reply.)

I posted, and then saw yours, and thought...

"Wow! We said the same thing!"

Great minds with but one thought. (lol)

That's my story, and I'm stickin' to it. :o)

Best regards,
Kathie

Print the post Back To Top
UnThreaded | Threaded | Whole Thread (11) | Ignore Thread Prev Thread | Next Thread
Advertisement