gaylin / gaylin.github.io Goto Github PK

I read Ammon Bartram's Taxonomy of Programmers and it made me wonder if there wasn't an equally appropriate taxonomy for the technical writing crowd.

Ideally they should be a littled closer to each other, a little more to the left. it would be great if there was some non-intrusive visual indicator of separation as well.

Although I'm specifically thinking about draft blog posts, I'd like a place to store files I'm still working on that may not necessarily end up as blog posts and I'd like to be able to preview them in the site to make sure they're what I'm aiming for.

It's probably fair to say that this is really more an update for the blog author, not the reader, now that I really think about it. But I know there are snippets of code out there that detect old browsers and say "Hey, you might wanna upgrade. This site would look so much better." My blog should do that for peeps.

Now that I've got the previous and next links working at the bottom of every post, I'd like for them to be prettier. At a minimum they need to stand out somehow a little better than they do. They currently get lost in the content of each post. I should consider:

• moving them to a different location (they're between the content and the disqus info right now)
• formatting them to be bigger or bolder or both (because right now they're really small)
• playing with the alignement (perhaps by centering)

Though I chafe at the name, perhaps the Hipster theme?

Right now the list of blog posts isn't so long as to be truly troubling. If I really continue down this path, however, there will come a time when scrolling through them all, or even simply viewing the list, will become fatiguing to the reader. I need to think of how best to group or paginate the posts to reduce this fatigue and make them visually more appealing.

The Made Mistakes sitemap is a nice one. I'm sure there are others. I just want it clear and easy to follow.

I want some way of knowing before I start in on an article, how long it might take me to finish it. Some sort of reading time indicator might be nice.

The font I'm currently using is the default and I'd like it to be a bit less...common.

With the newly revamped layout, I now realize that some of the images I've used in blog posts could be laid out better. In addition, the available layouts for all types of posts aren't well taken advantage of. I need to review each existing post and make sure that the code behind the displayed images is switched over to the new theme layout formatting. I also need to make sure that large header images are used where appropriate (they may not be appropriate). And I should probably take some notes on how those images can be best displayed and put them in some sort of docs directory so I don't have to keep looking them up on the theme's repo.

The 404 message that came with the them isn't up to my standards. I need the language to be improved and it would be really cool if it was clever at the same time.

Ideally I'd like them to exist in a draft state within the posts folder itself and simply be able to include some sort of true-false variable (draft: true or some such) in the YAML.

Either the size of the excerpt boxes needs to be smaller or I need to go through and update the excerpts to be more verbose. Right now they take up a lot of screen real estate.

It should cover how we structure things in a Jekyll repo and then turn that particular software on a pin and use it in ways that were never really intended when it was originally designed.

Right now post excerpts are ginormous on the index page. They need to be smaller so more posts will fit.

I like the way several blogs display a small snippet of text near the blog title on the index page. I like how the snippet serves as a summary and lets readers decide which post to examine first if they don't want to read them in chronological order.

In an ideal world I would want the snippet to be automatically generated unless I specifically told it either what the exact snippet should be or where the snippet should cut off if it merely started from the beginning of the post and went a certain length before the snippet cutoff.

I need to look into the license I have right now and then also the one for the theme I'm using to make sure I'm stating things correctly for both.

It's more than just the image being plain, though this is related to #75 in that regard. it's just that everything is so big. Even as responsive as the theme is on mobile, I think I want to see this banner page format with a slightly less tall image.

I want to be able to include things like projects or related work on my site that don't really fit into the blog post model.

c.f.:

• http://www.gnuterrypratchett.com/
• https://www.reddit.com/r/discworld/comments/2yt9j6/gnu_terry_pratchett/

alt.sysadmin.recovery we are not. We can do better than this: [1].

Right now to navigate between blog posts, readers of a particular post must click "blog" then find the post they want, click it, and then read it. I should make it easier to navigate in chronological order from the currently viewed blog post to older posts and newer posts if they exist.

I want to add comments into the _config.yml file so I can remember the general purpose of each of the items. Right now they're just in a list, added in the order I discovered them. I'd like to have them organized better so I can refer to the list later and scan things more quickly.

Warren Buffet said:

“In looking for people to hire, you look for three qualities: integrity, intelligence, and energy. And if they don’t have the first, the other two will kill you.”

Members who:

• are actively optimistic and positive, but honest about what the team has done and not done
• make decisions and take responsibility for their actions, even if the action results in failure
• work with integrity and honor, much like the ideal of medieval knighthood
• persevere, even in the face of huge disadvantage (they can't just be smart or technically savvy)
• understand that they are part of something greater than themselves (kind, trustworthy, reliable partners)

Although it's probably ego-driven, the idea of social sharing icons on posts intrigues me. I like the idea of people being able to click and auto-generate a suggested post to the social network of choice. Right now I think I'd focus on:

• twitter
• facebook
• google+

I've seen places where text in large quantity, usually code or formatting examples (or Mech builds) are conveniently hidden in a collapsing menu. I'd like to have that capability in some areas of my blog.

I'm speaking at Write the Docs NA 2015:

Pie in the sky dream? Make my slides and speaking notes available to anyone who wants to read them, either online or in downloadable format. At the very least, the notes have to include the 7.5 rules of becoming a great writer of documentation.