TMContent / Lib_Docs

Creative Commons Zero v1.0 Universal
1 stars 2 forks source link

Engaging Users with Content #10

Open BendixSpring opened 11 years ago

BendixSpring commented 11 years ago
I had a long chat with Dinis yesterday, and it got me charged up about TeamMentor. I see TM being used to help development teams (the entire team, not just the coders) to build more secure, robust applications. This means the tool has to be genuinely helpful and increase productivity. So things that inhibit productivity, frustrate the user, or overwhelm the user are not helpful and must be eliminated from TM. This concept applies to TM admins as well -- make it easy to administer. Thus, I believe we need to make sure we are constantly considering the user -- how would the user do X? Is it obvious? Easy to do? Intuitive? Fast? Spot-on? Another consideration is making TM more engaging for the user. Granted, it has a fun UI, but that is not sufficiently engaging. You might ask, "What do you mean? It's a tool. Compilers aren't engaging. Why should TM be any different?" A fair question. I'd argue that an engaging tool is one that is more likely to be picked up and used. When it comes down to it, in order to TM to be useful, the DevTeam needs to use it all time. That means keeping it open in the IDE or desktop and referencing it all the time. The hard part is getting the user to do that. I'd suggest that making TM more engaging is one way. I don't have the answers, but I do have some suggestions. So here are some suggestions for helping to make using TM more engaging for the user. 1. Allow the user to hit a button that will display a random article, based on current filters or from any of the libraries. 2. Create a library called Most Popular. It would have one landing page, and it would list in rank order the most popular articles. This should be dynamic, so articles would move up and down the list over time. 3. Create another library called Must Read or Hot Topics. This would have the 5 or 10 most important articles for a given technology or topic. Perhaps even broken out by basic, intermediate, advanced. 4. Have another button or library called Today's Topic. This topic would be displayed by default when a user would login to the site or when the user would click the Today's Topic button. 5. What's New: show users what the new or updated content. Don't make them work hard to find it. And with new content showing up daily, folks know that content isn't getting stale. 6. Games/Quizzes/Puzzles: Many developers like a good challenge. Perhaps do a 3 or 5 point quiz after certain key topics (things a developer MUST know). The scores could be used by the company to foster healthy competition among the developers. Or have a button that will pop a random chunk of bad code so the user can play "Spot the vulnerability" (maybe something they can copy and paste into their IDE. They would have to fix it.) There is an interesting tool at NIST that has examples of good and bad code: http://samate.nist.gov/SRD/view.php Perhaps some of the most common issues could be used for “Spot the vulnerability” games. If not that, then the SAMATE database had lots of examples of code to include in the detailed write-ups in TeamMentor. I have more ideas, but that will be for another time (they are more complex). --Danny
DinisCruz commented 11 years ago

Great entry, and it looks like this text should live in a blog post :)

Dinis Cruz

On 4 Apr 2013, at 23:01, Danny Harris notifications@github.com wrote:

I had a long chat with Dinis yesterday, and it got me charged up about TeamMentor.

I see TM being used to help development teams (the entire team, not just the coders) to build more secure, robust applications. This means the tool has to be genuinely helpful and increase productivity. So things that inhibit productivity, frustrate the user, or overwhelm the user are not helpful and must be eliminated from TM. This concept applies to TM admins as well -- make it easy to administer.

Thus, I believe we need to make sure we are constantly considering the user -- how would the user do X? Is it obvious? Easy to do? Intuitive? Fast? Spot-on?

Another consideration is making TM more engaging for the user. Granted, it has a fun UI, but that is not sufficiently engaging. You might ask, "What do you mean? It's a tool. Compilers aren't engaging. Why should TM be any different?" A fair question. I'd argue that an engaging tool is one that is more likely to be picked up and used. When it comes down to it, in order to TM to be useful, the DevTeam needs to use it all time. That means keeping it open in the IDE or desktop and referencing it all the time. The hard part is getting the user to do that. I'd suggest that making TM more engaging is one way. I don't have the answers, but I do have some suggestions.

So here are some suggestions for helping to make using TM more engaging for the user.

Allow the user to hit a button that will display a random article, based on current filters or from any of the libraries.

Create a library called Most Popular. It would have one landing page, and it would list in rank order the most popular articles. This should be dynamic, so articles would move up and down the list over time.

Create another library called Must Read or Hot Topics. This would have the 5 or 10 most important articles for a given technology or topic. Perhaps even broken out by basic, intermediate, advanced.

Have another button or library called Today's Topic. This topic would be displayed by default when a user would login to the site or when the user would click the Today's Topic button.

What's New: show users what the new or updated content. Don't make them work hard to find it. And with new content showing up daily, folks know that content isn't getting stale.

Games/Quizzes/Puzzles: Many developers like a good challenge. Perhaps do a 3 or 5 point quiz after certain key topics (things a developer MUST know). The scores could be used by the company to foster healthy competition among the developers. Or have a button that will pop a random chunk of bad code so the user can play "Spot the vulnerability" (maybe something they can copy and paste into their IDE. They would have to fix it.) There is an interesting tool at NIST that has examples of good and bad code: http://samate.nist.gov/SRD/view.php Perhaps some of the most common issues could be used for “Spot the vulnerability” games. If not that, then the SAMATE database had lots of examples of code to include in the detailed write-ups in TeamMentor.

I have more ideas, but that will be for another time (they are more complex).

--Danny

— Reply to this email directly or view it on GitHub.

BendixSpring commented 11 years ago

Dinis:

Can you recommend a blog for me? I’m not sure if SI has something or if I should use google or something like that.

--Danny

From: Dinis Cruz [mailto:notifications@github.com] Sent: Thursday, April 04, 2013 6:17 PM To: TMContent/Lib_Docs Cc: Danny Harris Subject: Re: [Lib_Docs] Engaging Users with Content (#10)

Great entry, and it looks like this text should live in a blog post :)

Dinis Cruz

On 4 Apr 2013, at 23:01, Danny Harris <notifications@github.com mailto:notifications@github.com > wrote:

I had a long chat with Dinis yesterday, and it got me charged up about TeamMentor.

I see TM being used to help development teams (the entire team, not just the coders) to build more secure, robust applications. This means the tool has to be genuinely helpful and increase productivity. So things that inhibit productivity, frustrate the user, or overwhelm the user are not helpful and must be eliminated from TM. This concept applies to TM admins as well -- make it easy to administer.

Thus, I believe we need to make sure we are constantly considering the user -- how would the user do X? Is it obvious? Easy to do? Intuitive? Fast? Spot-on?

Another consideration is making TM more engaging for the user. Granted, it has a fun UI, but that is not sufficiently engaging. You might ask, "What do you mean? It's a tool. Compilers aren't engaging. Why should TM be any different?" A fair question. I'd argue that an engaging tool is one that is more likely to be picked up and used. When it comes down to it, in order to TM to be useful, the DevTeam needs to use it all time. That means keeping it open in the IDE or desktop and referencing it all the time. The hard part is getting the user to do that. I'd suggest that making TM more engaging is one way. I don't have the answers, but I do have some suggestions.

So here are some suggestions for helping to make using TM more engaging for the user.

Allow the user to hit a button that will display a random article, based on current filters or from any of the libraries.

Create a library called Most Popular. It would have one landing page, and it would list in rank order the most popular articles. This should be dynamic, so articles would move up and down the list over time.

Create another library called Must Read or Hot Topics. This would have the 5 or 10 most important articles for a given technology or topic. Perhaps even broken out by basic, intermediate, advanced.

Have another button or library called Today's Topic. This topic would be displayed by default when a user would login to the site or when the user would click the Today's Topic button.

What's New: show users what the new or updated content. Don't make them work hard to find it. And with new content showing up daily, folks know that content isn't getting stale.

Games/Quizzes/Puzzles: Many developers like a good challenge. Perhaps do a 3 or 5 point quiz after certain key topics (things a developer MUST know). The scores could be used by the company to foster healthy competition among the developers. Or have a button that will pop a random chunk of bad code so the user can play "Spot the vulnerability" (maybe something they can copy and paste into their IDE. They would have to fix it.) There is an interesting tool at NIST that has examples of good and bad code: http://samate.nist.gov/SRD/view.php Perhaps some of the most common issues could be used for “Spot the vulnerability” games. If not that, then the SAMATE database had lots of examples of code to include in the detailed write-ups in TeamMentor.

I have more ideas, but that will be for another time (they are more complex).

--Danny

— Reply to this email directly or view it on GitHub.

— Reply to this email directly or view it on GitHub https://github.com/TMContent/Lib_Docs/issues/10#issuecomment-15927607 . https://github.com/notifications/beacon/5F2_eRmNmMOSmJQY77zQByef40hcDWrjGeTYyOhUYj7RENYG2PcNRkUDXrMf53UO.gif

arvinddoraiswamy commented 11 years ago

You could blog at http(s)://teammentordevelopment.wordpress.com :) .. although someone needs to approve you :D .. I don't have perms to do that.

Arvind

On Thu, Apr 4, 2013 at 7:09 PM, Danny Harris notifications@github.comwrote:

Dinis:

Can you recommend a blog for me? I’m not sure if SI has something or if I should use google or something like that.

--Danny

From: Dinis Cruz [mailto:notifications@github.com] Sent: Thursday, April 04, 2013 6:17 PM To: TMContent/Lib_Docs Cc: Danny Harris Subject: Re: [Lib_Docs] Engaging Users with Content (#10)

Great entry, and it looks like this text should live in a blog post :)

Dinis Cruz

On 4 Apr 2013, at 23:01, Danny Harris <notifications@github.com <mailto: notifications@github.com> > wrote:

I had a long chat with Dinis yesterday, and it got me charged up about TeamMentor.

I see TM being used to help development teams (the entire team, not just the coders) to build more secure, robust applications. This means the tool has to be genuinely helpful and increase productivity. So things that inhibit productivity, frustrate the user, or overwhelm the user are not helpful and must be eliminated from TM. This concept applies to TM admins as well -- make it easy to administer.

Thus, I believe we need to make sure we are constantly considering the user -- how would the user do X? Is it obvious? Easy to do? Intuitive? Fast? Spot-on?

Another consideration is making TM more engaging for the user. Granted, it has a fun UI, but that is not sufficiently engaging. You might ask, "What do you mean? It's a tool. Compilers aren't engaging. Why should TM be any different?" A fair question. I'd argue that an engaging tool is one that is more likely to be picked up and used. When it comes down to it, in order to TM to be useful, the DevTeam needs to use it all time. That means keeping it open in the IDE or desktop and referencing it all the time. The hard part is getting the user to do that. I'd suggest that making TM more engaging is one way. I don't have the answers, but I do have some suggestions.

So here are some suggestions for helping to make using TM more engaging for the user.

Allow the user to hit a button that will display a random article, based on current filters or from any of the libraries.

Create a library called Most Popular. It would have one landing page, and it would list in rank order the most popular articles. This should be dynamic, so articles would move up and down the list over time.

Create another library called Must Read or Hot Topics. This would have the 5 or 10 most important articles for a given technology or topic. Perhaps even broken out by basic, intermediate, advanced.

Have another button or library called Today's Topic. This topic would be displayed by default when a user would login to the site or when the user would click the Today's Topic button.

What's New: show users what the new or updated content. Don't make them work hard to find it. And with new content showing up daily, folks know that content isn't getting stale.

Games/Quizzes/Puzzles: Many developers like a good challenge. Perhaps do a 3 or 5 point quiz after certain key topics (things a developer MUST know). The scores could be used by the company to foster healthy competition among the developers. Or have a button that will pop a random chunk of bad code so the user can play "Spot the vulnerability" (maybe something they can copy and paste into their IDE. They would have to fix it.) There is an interesting tool at NIST that has examples of good and bad code: http://samate.nist.gov/SRD/view.php Perhaps some of the most common issues could be used for “Spot the vulnerability” games. If not that, then the SAMATE database had lots of examples of code to include in the detailed write-ups in TeamMentor.

I have more ideas, but that will be for another time (they are more complex).

--Danny

— Reply to this email directly or view it on GitHub.

— Reply to this email directly or view it on GitHub < https://github.com/TMContent/Lib_Docs/issues/10#issuecomment-15927607> . < https://github.com/notifications/beacon/5F2_eRmNmMOSmJQY77zQByef40hcDWrjGeTYyOhUYj7RENYG2PcNRkUDXrMf53UO.gif>

— Reply to this email directly or view it on GitHubhttps://github.com/TMContent/Lib_Docs/issues/10#issuecomment-15929861 .

romichg commented 11 years ago

Danny, let me know when you blogged this so we can close this issue in this lib. On Apr 5, 2013 4:46 AM, "arvinddoraiswamy" notifications@github.com wrote:

You could blog at http(s)://teammentordevelopment.wordpress.com :) .. although someone needs to approve you :D .. I don't have perms to do that.

Arvind

On Thu, Apr 4, 2013 at 7:09 PM, Danny Harris notifications@github.comwrote:

Dinis:

Can you recommend a blog for me? I’m not sure if SI has something or if I should use google or something like that.

--Danny

From: Dinis Cruz [mailto:notifications@github.com] Sent: Thursday, April 04, 2013 6:17 PM To: TMContent/Lib_Docs Cc: Danny Harris Subject: Re: [Lib_Docs] Engaging Users with Content (#10)

Great entry, and it looks like this text should live in a blog post :)

Dinis Cruz

On 4 Apr 2013, at 23:01, Danny Harris <notifications@github.com <mailto: notifications@github.com> > wrote:

I had a long chat with Dinis yesterday, and it got me charged up about TeamMentor.

I see TM being used to help development teams (the entire team, not just the coders) to build more secure, robust applications. This means the tool has to be genuinely helpful and increase productivity. So things that inhibit productivity, frustrate the user, or overwhelm the user are not helpful and must be eliminated from TM. This concept applies to TM admins as well -- make it easy to administer.

Thus, I believe we need to make sure we are constantly considering the user -- how would the user do X? Is it obvious? Easy to do? Intuitive? Fast? Spot-on?

Another consideration is making TM more engaging for the user. Granted, it has a fun UI, but that is not sufficiently engaging. You might ask, "What do you mean? It's a tool. Compilers aren't engaging. Why should TM be any different?" A fair question. I'd argue that an engaging tool is one that is more likely to be picked up and used. When it comes down to it, in order to TM to be useful, the DevTeam needs to use it all time. That means keeping it open in the IDE or desktop and referencing it all the time. The hard part is getting the user to do that. I'd suggest that making TM more engaging is one way. I don't have the answers, but I do have some suggestions.

So here are some suggestions for helping to make using TM more engaging for the user.

Allow the user to hit a button that will display a random article, based on current filters or from any of the libraries.

Create a library called Most Popular. It would have one landing page, and it would list in rank order the most popular articles. This should be dynamic, so articles would move up and down the list over time.

Create another library called Must Read or Hot Topics. This would have the 5 or 10 most important articles for a given technology or topic. Perhaps even broken out by basic, intermediate, advanced.

Have another button or library called Today's Topic. This topic would be displayed by default when a user would login to the site or when the user would click the Today's Topic button.

What's New: show users what the new or updated content. Don't make them work hard to find it. And with new content showing up daily, folks know that content isn't getting stale.

Games/Quizzes/Puzzles: Many developers like a good challenge. Perhaps do a 3 or 5 point quiz after certain key topics (things a developer MUST know). The scores could be used by the company to foster healthy competition among the developers. Or have a button that will pop a random chunk of bad code so the user can play "Spot the vulnerability" (maybe something they can copy and paste into their IDE. They would have to fix it.) There is an interesting tool at NIST that has examples of good and bad code: http://samate.nist.gov/SRD/view.php Perhaps some of the most common issues could be used for “Spot the vulnerability” games. If not that, then the SAMATE database had lots of examples of code to include in the detailed write-ups in TeamMentor.

I have more ideas, but that will be for another time (they are more complex).

--Danny

— Reply to this email directly or view it on GitHub.

— Reply to this email directly or view it on GitHub < https://github.com/TMContent/Lib_Docs/issues/10#issuecomment-15927607> . <

https://github.com/notifications/beacon/5F2_eRmNmMOSmJQY77zQByef40hcDWrjGeTYyOhUYj7RENYG2PcNRkUDXrMf53UO.gif>

— Reply to this email directly or view it on GitHub< https://github.com/TMContent/Lib_Docs/issues/10#issuecomment-15929861> .

— Reply to this email directly or view it on GitHubhttps://github.com/TMContent/Lib_Docs/issues/10#issuecomment-15930130 .

DinisCruz commented 11 years ago

Danny, I just went to wordpress.com and added you as an user for TM's blog

You should have an invite now

Dinis Cruz

Blog: http://diniscruz.blogspot.com Twitter: http://twitter.com/DinisCruz Web: http://www.owasp.org/index.php/O2

On 8 April 2013 12:24, Roman Garber notifications@github.com wrote:

Danny, let me know when you blogged this so we can close this issue in this lib. On Apr 5, 2013 4:46 AM, "arvinddoraiswamy" notifications@github.com wrote:

You could blog at http(s)://teammentordevelopment.wordpress.com :) .. although someone needs to approve you :D .. I don't have perms to do that.

Arvind

On Thu, Apr 4, 2013 at 7:09 PM, Danny Harris notifications@github.comwrote:

Dinis:

Can you recommend a blog for me? I’m not sure if SI has something or if I should use google or something like that.

--Danny

From: Dinis Cruz [mailto:notifications@github.com] Sent: Thursday, April 04, 2013 6:17 PM To: TMContent/Lib_Docs Cc: Danny Harris Subject: Re: [Lib_Docs] Engaging Users with Content (#10)

Great entry, and it looks like this text should live in a blog post :)

Dinis Cruz

On 4 Apr 2013, at 23:01, Danny Harris <notifications@github.com<mailto: notifications@github.com> > wrote:

I had a long chat with Dinis yesterday, and it got me charged up about TeamMentor.

I see TM being used to help development teams (the entire team, not just the coders) to build more secure, robust applications. This means the tool has to be genuinely helpful and increase productivity. So things that inhibit productivity, frustrate the user, or overwhelm the user are not helpful and must be eliminated from TM. This concept applies to TM admins as well -- make it easy to administer.

Thus, I believe we need to make sure we are constantly considering the user -- how would the user do X? Is it obvious? Easy to do? Intuitive? Fast? Spot-on?

Another consideration is making TM more engaging for the user. Granted, it has a fun UI, but that is not sufficiently engaging. You might ask, "What do you mean? It's a tool. Compilers aren't engaging. Why should TM be any different?" A fair question. I'd argue that an engaging tool is one that is more likely to be picked up and used. When it comes down to it, in order to TM to be useful, the DevTeam needs to use it all time. That means keeping it open in the IDE or desktop and referencing it all the time. The hard part is getting the user to do that. I'd suggest that making TM more engaging is one way. I don't have the answers, but I do have some suggestions.

So here are some suggestions for helping to make using TM more engaging for the user.

Allow the user to hit a button that will display a random article, based on current filters or from any of the libraries.

Create a library called Most Popular. It would have one landing page, and it would list in rank order the most popular articles. This should be dynamic, so articles would move up and down the list over time.

Create another library called Must Read or Hot Topics. This would have the 5 or 10 most important articles for a given technology or topic. Perhaps even broken out by basic, intermediate, advanced.

Have another button or library called Today's Topic. This topic would be displayed by default when a user would login to the site or when the user would click the Today's Topic button.

What's New: show users what the new or updated content. Don't make them work hard to find it. And with new content showing up daily, folks know that content isn't getting stale.

Games/Quizzes/Puzzles: Many developers like a good challenge. Perhaps do a 3 or 5 point quiz after certain key topics (things a developer MUST know). The scores could be used by the company to foster healthy competition among the developers. Or have a button that will pop a random chunk of bad code so the user can play "Spot the vulnerability" (maybe something they can copy and paste into their IDE. They would have to fix it.) There is an interesting tool at NIST that has examples of good and bad code: http://samate.nist.gov/SRD/view.php Perhaps some of the most common issues could be used for “Spot the vulnerability” games. If not that, then the SAMATE database had lots of examples of code to include in the detailed write-ups in TeamMentor.

I have more ideas, but that will be for another time (they are more complex).

--Danny

— Reply to this email directly or view it on GitHub.

— Reply to this email directly or view it on GitHub < https://github.com/TMContent/Lib_Docs/issues/10#issuecomment-15927607>

. <

https://github.com/notifications/beacon/5F2_eRmNmMOSmJQY77zQByef40hcDWrjGeTYyOhUYj7RENYG2PcNRkUDXrMf53UO.gif>

— Reply to this email directly or view it on GitHub< https://github.com/TMContent/Lib_Docs/issues/10#issuecomment-15929861> .

— Reply to this email directly or view it on GitHub< https://github.com/TMContent/Lib_Docs/issues/10#issuecomment-15930130> .

— Reply to this email directly or view it on GitHubhttps://github.com/TMContent/Lib_Docs/issues/10#issuecomment-16045111 .

BendixSpring commented 11 years ago

Dinis:

I updated my password to Wordpress, but I don’t seem to have access to write to the TeamMentor blog. My account is BendixSpring.

--Danny

From: Dinis Cruz [mailto:notifications@github.com] Sent: Monday, April 08, 2013 9:22 AM To: TMContent/Lib_Docs Cc: Danny Harris Subject: Re: [Lib_Docs] Engaging Users with Content (#10)

Danny, I just went to wordpress.com and added you as an user for TM's blog

You should have an invite now

Dinis Cruz

Blog: http://diniscruz.blogspot.com Twitter: http://twitter.com/DinisCruz Web: http://www.owasp.org/index.php/O2

On 8 April 2013 12:24, Roman Garber notifications@github.com wrote:

Danny, let me know when you blogged this so we can close this issue in this lib. On Apr 5, 2013 4:46 AM, "arvinddoraiswamy" notifications@github.com wrote:

You could blog at http(s)://teammentordevelopment.wordpress.com :) .. although someone needs to approve you :D .. I don't have perms to do that.

Arvind

On Thu, Apr 4, 2013 at 7:09 PM, Danny Harris notifications@github.comwrote:

Dinis:

Can you recommend a blog for me? I’m not sure if SI has something or if I should use google or something like that.

--Danny

From: Dinis Cruz [mailto:notifications@github.com] Sent: Thursday, April 04, 2013 6:17 PM To: TMContent/Lib_Docs Cc: Danny Harris Subject: Re: [Lib_Docs] Engaging Users with Content (#10)

Great entry, and it looks like this text should live in a blog post :)

Dinis Cruz

On 4 Apr 2013, at 23:01, Danny Harris <notifications@github.com<mailto: notifications@github.com> > wrote:

I had a long chat with Dinis yesterday, and it got me charged up about TeamMentor.

I see TM being used to help development teams (the entire team, not just the coders) to build more secure, robust applications. This means the tool has to be genuinely helpful and increase productivity. So things that inhibit productivity, frustrate the user, or overwhelm the user are not helpful and must be eliminated from TM. This concept applies to TM admins as well -- make it easy to administer.

Thus, I believe we need to make sure we are constantly considering the user -- how would the user do X? Is it obvious? Easy to do? Intuitive? Fast? Spot-on?

Another consideration is making TM more engaging for the user. Granted, it has a fun UI, but that is not sufficiently engaging. You might ask, "What do you mean? It's a tool. Compilers aren't engaging. Why should TM be any different?" A fair question. I'd argue that an engaging tool is one that is more likely to be picked up and used. When it comes down to it, in order to TM to be useful, the DevTeam needs to use it all time. That means keeping it open in the IDE or desktop and referencing it all the time. The hard part is getting the user to do that. I'd suggest that making TM more engaging is one way. I don't have the answers, but I do have some suggestions.

So here are some suggestions for helping to make using TM more engaging for the user.

Allow the user to hit a button that will display a random article, based on current filters or from any of the libraries.

Create a library called Most Popular. It would have one landing page, and it would list in rank order the most popular articles. This should be dynamic, so articles would move up and down the list over time.

Create another library called Must Read or Hot Topics. This would have the 5 or 10 most important articles for a given technology or topic. Perhaps even broken out by basic, intermediate, advanced.

Have another button or library called Today's Topic. This topic would be displayed by default when a user would login to the site or when the user would click the Today's Topic button.

What's New: show users what the new or updated content. Don't make them work hard to find it. And with new content showing up daily, folks know that content isn't getting stale.

Games/Quizzes/Puzzles: Many developers like a good challenge. Perhaps do a 3 or 5 point quiz after certain key topics (things a developer MUST know). The scores could be used by the company to foster healthy competition among the developers. Or have a button that will pop a random chunk of bad code so the user can play "Spot the vulnerability" (maybe something they can copy and paste into their IDE. They would have to fix it.) There is an interesting tool at NIST that has examples of good and bad code: http://samate.nist.gov/SRD/view.php Perhaps some of the most common issues could be used for “Spot the vulnerability” games. If not that, then the SAMATE database had lots of examples of code to include in the detailed write-ups in TeamMentor.

I have more ideas, but that will be for another time (they are more complex).

--Danny

— Reply to this email directly or view it on GitHub.

— Reply to this email directly or view it on GitHub < https://github.com/TMContent/Lib_Docs/issues/10#issuecomment-15927607>

. <

https://github.com/notifications/beacon/5F2_eRmNmMOSmJQY77zQByef40hcDWrjGeTYyOhUYj7RENYG2PcNRkUDXrMf53UO.gif>

— Reply to this email directly or view it on GitHub< https://github.com/TMContent/Lib_Docs/issues/10#issuecomment-15929861> .

— Reply to this email directly or view it on GitHub< https://github.com/TMContent/Lib_Docs/issues/10#issuecomment-15930130> .

— Reply to this email directly or view it on GitHubhttps://github.com/TMContent/Lib_Docs/issues/10#issuecomment-16045111 .

— Reply to this email directly or view it on GitHub https://github.com/TMContent/Lib_Docs/issues/10#issuecomment-16049786 .

BendixSpring commented 11 years ago

Done: http://teammentordevelopment.wordpress.com/2013/04/08/engaging-users-with-content/

--Danny

From: Roman Garber [mailto:notifications@github.com] Sent: Monday, April 08, 2013 7:24 AM To: TMContent/Lib_Docs Cc: Danny Harris Subject: Re: [Lib_Docs] Engaging Users with Content (#10)

Danny, let me know when you blogged this so we can close this issue in this lib. On Apr 5, 2013 4:46 AM, "arvinddoraiswamy" <notifications@github.com mailto:notifications@github.com > wrote:

You could blog at http(s)://teammentordevelopment.wordpress.com :) .. although someone needs to approve you :D .. I don't have perms to do that.

Arvind

On Thu, Apr 4, 2013 at 7:09 PM, Danny Harris <notifications@github.com mailto:notifications@github.com >wrote:

Dinis:

Can you recommend a blog for me? I’m not sure if SI has something or if I should use google or something like that.

--Danny

From: Dinis Cruz [mailto:notifications@github.com] Sent: Thursday, April 04, 2013 6:17 PM To: TMContent/Lib_Docs Cc: Danny Harris Subject: Re: [Lib_Docs] Engaging Users with Content (#10)

Great entry, and it looks like this text should live in a blog post :)

Dinis Cruz

On 4 Apr 2013, at 23:01, Danny Harris <notifications@github.com mailto:notifications@github.com%20%3cmailto:%20%0b <mailto: notifications@github.com mailto:notifications@github.com > > wrote:

I had a long chat with Dinis yesterday, and it got me charged up about TeamMentor.

I see TM being used to help development teams (the entire team, not just the coders) to build more secure, robust applications. This means the tool has to be genuinely helpful and increase productivity. So things that inhibit productivity, frustrate the user, or overwhelm the user are not helpful and must be eliminated from TM. This concept applies to TM admins as well -- make it easy to administer.

Thus, I believe we need to make sure we are constantly considering the user -- how would the user do X? Is it obvious? Easy to do? Intuitive? Fast? Spot-on?

Another consideration is making TM more engaging for the user. Granted, it has a fun UI, but that is not sufficiently engaging. You might ask, "What do you mean? It's a tool. Compilers aren't engaging. Why should TM be any different?" A fair question. I'd argue that an engaging tool is one that is more likely to be picked up and used. When it comes down to it, in order to TM to be useful, the DevTeam needs to use it all time. That means keeping it open in the IDE or desktop and referencing it all the time. The hard part is getting the user to do that. I'd suggest that making TM more engaging is one way. I don't have the answers, but I do have some suggestions.

So here are some suggestions for helping to make using TM more engaging for the user.

Allow the user to hit a button that will display a random article, based on current filters or from any of the libraries.

Create a library called Most Popular. It would have one landing page, and it would list in rank order the most popular articles. This should be dynamic, so articles would move up and down the list over time.

Create another library called Must Read or Hot Topics. This would have the 5 or 10 most important articles for a given technology or topic. Perhaps even broken out by basic, intermediate, advanced.

Have another button or library called Today's Topic. This topic would be displayed by default when a user would login to the site or when the user would click the Today's Topic button.

What's New: show users what the new or updated content. Don't make them work hard to find it. And with new content showing up daily, folks know that content isn't getting stale.

Games/Quizzes/Puzzles: Many developers like a good challenge. Perhaps do a 3 or 5 point quiz after certain key topics (things a developer MUST know). The scores could be used by the company to foster healthy competition among the developers. Or have a button that will pop a random chunk of bad code so the user can play "Spot the vulnerability" (maybe something they can copy and paste into their IDE. They would have to fix it.) There is an interesting tool at NIST that has examples of good and bad code: http://samate.nist.gov/SRD/view.php Perhaps some of the most common issues could be used for “Spot the vulnerability” games. If not that, then the SAMATE database had lots of examples of code to include in the detailed write-ups in TeamMentor.

I have more ideas, but that will be for another time (they are more complex).

--Danny

— Reply to this email directly or view it on GitHub.

— Reply to this email directly or view it on GitHub < https://github.com/TMContent/Lib_Docs/issues/10#issuecomment-15927607> . <

https://github.com/notifications/beacon/5F2_eRmNmMOSmJQY77zQByef40hcDWrjGeTYyOhUYj7RENYG2PcNRkUDXrMf53UO.gif>

— Reply to this email directly or view it on GitHub< https://github.com/TMContent/Lib_Docs/issues/10#issuecomment-15929861> .

— Reply to this email directly or view it on GitHubhttps://github.com/TMContent/Lib_Docs/issues/10#issuecomment-15930130 .

— Reply to this email directly or view it on GitHub https://github.com/TMContent/Lib_Docs/issues/10#issuecomment-16045111 . https://github.com/notifications/beacon/5F2_eRmNmMOSmJQY77zQByef40hcDWrjGeTYyOhUYj7RENYG2PcNRkUDXrMf53UO.gif