Register a SA Forums Account here!
JOINING THE SA FORUMS WILL REMOVE THIS BIG AD, THE ANNOYING UNDERLINED ADS, AND STUPID INTERSTITIAL ADS!!!

You can: log in, read the tech support FAQ, or request your lost password. This dumb message (and those ads) will appear on every screen until you register! Get rid of this crap by registering your own SA Forums Account and joining roughly 150,000 Goons, for the one-time price of $9.95! We charge money because it costs us money per month for bills, and since we don't believe in showing ads to our users, we try to make the money back through forum registrations.
 
  • Locked thread
Guy Axlerod
Dec 29, 2008

orange sky posted:

Guys, I need an opinion on something. I'm implementing stuff in a company and I need to write manuals for Helpdesk use. Is there any template that you guys found particularly easy to use? Any general guidelines? It's the first one I'm doing ever and I wanna do something good. I've got screenshots for every. drat. step. So what I'm looking for is a general structure (should I use tables with steps? something to differentiate what users must do and what helpdesk must do?). Thing is, what I'm doing might look comprehensible to me but I know every step by heart by now, so I'm not 100% sure someone else will understand what I mean.

I've always been of the opinion that if they can see the screen, screenshots are generally unnecessary. A feel-good checkpoint screenshot is OK. Otherwise if this is a call center, and the screen is on the other end of the phone, or the UI is so incomprehensible that it can't be described in words, then go nuts with screenshots.

Use a numbered list for steps and use sub-procedures. (Example: 1. Open an elevated command prompt. 1a. Select [Start]. 1b. Type etc. This way an experienced user can skip to the meat while no alienating novices.)

Experience is hard to fight. Go through your procedures and make sure everything you do is written down. If you're really trying hard, try to think of a way of doing it wrong that still fits in your instructions.

If there is more than one way to do things, pick one for the instructions, or explain how the user should choose if it matters. If you were writing instructions for the assembly of a chair, don't say "Attach either arm, and then the other", say "Attach the left arm, and then the right arm". Even though it probably doesn't matter, you will save your user a decision.

Adbot
ADBOT LOVES YOU

Centripetal Horse
Nov 22, 2009

Fuck money, get GBS

This could have bought you a half a tank of gas, lmfao -
Love, gromdul

orange sky posted:

Guys, I need an opinion on something. I'm implementing stuff in a company and I need to write manuals for Helpdesk use. Is there any template that you guys found particularly easy to use? Any general guidelines? It's the first one I'm doing ever and I wanna do something good. I've got screenshots for every. drat. step. So what I'm looking for is a general structure (should I use tables with steps? something to differentiate what users must do and what helpdesk must do?). Thing is, what I'm doing might look comprehensible to me but I know every step by heart by now, so I'm not 100% sure someone else will understand what I mean.

I love screenshots for multi-step processes. I don't know of any templates off the top of my head, but I recommend laying on the screenshots pretty heavily. I think this even more true since you already have the screenshots. The person above me mentioned screenshots not being that important if the user can have the actual page/screen open in front of him. I disagree, because "Open the 'Tools' menu" is enough to throw off a significant portion of users. When writing an opinion essay, I've heard that you're supposed to close with a reiteration of your opening statement, so: I love screenshots for multi-step processes.

m.hache
Dec 1, 2004


Fun Shoe
Also, perhaps this will make things much easier for you

http://windows.microsoft.com/en-ca/windows7/how-do-i-use-problem-steps-recorder

spiny
May 20, 2004

round and round and round

Guy Axlerod posted:

If there is more than one way to do things, pick one for the instructions, or explain how the user should choose if it matters. If you were writing instructions for the assembly of a chair, don't say "Attach either arm, and then the other", say "Attach the left arm, and then the right arm". Even though it probably doesn't matter, you will save your user a decision.

I like this :)

I've got to write some docs for our customers on how to change their voicemail messages to show they are in holiday mode, so I'll bear this in mind, as though bitter experience, some of them can find the most arcane ways to screw stuff up, even with (what I would consider) clear instructions ...

skooky
Oct 2, 2013

I swear this is the number one thing that gets me the "Are you a wizard?" look from colleagues. I've no idea why it isn't more widely known.

BurgerQuest
Mar 17, 2009

by Jeffrey of YOSPOS
Confluence is pretty great for writing how to documents, combined with the windows snipping tool I have been punching out howtos all week as part of my handover plan.

It's only :tenbux: for ten users and we just use one of those licenses for a generic read-only account as there's only about 5 of us who actually need to add to it.

For the price I can't recommend it enough for structured technical documentation. And it exports nice to word/PDF if you need.

Proteus Jones
Feb 28, 2013



skooky posted:

I swear this is the number one thing that gets me the "Are you a wizard?" look from colleagues. I've no idea why it isn't more widely known.

I have never heard of it before today. While I mostly work on a Mac, when I'm in the office I do use my Windows box and I can totally see using this when presenting mock-ups for new procedures for some of the projects I do. There are also some people who create staging and setup documentation that I know who will think I'm the second coming of Jesus when I show them this.

Thanks Ants
May 21, 2004

#essereFerrari


We deployed a shortcut to psr.exe onto the desktop at my old job, and the helpdesk pretty much bribed people to use it by very visibly resolving tickets first if they had a recording attached.

incoherent
Apr 24, 2004

01010100011010000111001
00110100101101100011011
000110010101110010

BurgerQuest posted:

Confluence is pretty great for writing how to documents, combined with the windows snipping tool I have been punching out howtos all week as part of my handover plan.

It's only :tenbux: for ten users and we just use one of those licenses for a generic read-only account as there's only about 5 of us who actually need to add to it.

For the price I can't recommend it enough for structured technical documentation. And it exports nice to word/PDF if you need.

Yup I got the license for my org so I can hop in and vomit brain matter into a document.

duffmensch
Feb 20, 2004

Duffman is thrusting in the direction of the problem!

orange sky posted:

Guys, I need an opinion on something. I'm implementing stuff in a company and I need to write manuals for Helpdesk use. Is there any template that you guys found particularly easy to use? Any general guidelines? It's the first one I'm doing ever and I wanna do something good. I've got screenshots for every. drat. step. So what I'm looking for is a general structure (should I use tables with steps? something to differentiate what users must do and what helpdesk must do?). Thing is, what I'm doing might look comprehensible to me but I know every step by heart by now, so I'm not 100% sure someone else will understand what I mean.

Something that always served me well was to have someone not intimately involved in the process (I usually hit up one of the admin assistants) to review the document to make sure that it makes sense and that you didn't accidentally skip a step.

Centripetal Horse
Nov 22, 2009

Fuck money, get GBS

This could have bought you a half a tank of gas, lmfao -
Love, gromdul

Thanks Ants posted:

We deployed a shortcut to psr.exe onto the desktop at my old job, and the helpdesk pretty much bribed people to use it by very visibly resolving tickets first if they had a recording attached.

I think the word is "extorted," but they're users, so they probably had it coming.

orange sky
May 7, 2007


Holy. poo poo.

Ahahahah

Migishu
Oct 22, 2005

I'll eat your fucking eyeballs if you're not careful

Grimey Drawer
Oh hey a new Lync woe:

Lync is now, randomly, preventing me from seeing new messages. People are sending them, and the client is receiving them, but it will not show in the Lync windows at all. Affects all Lync tabs.

Only way to fix this is to restart Lync.

God loving drat this is a horribly coded program.

Bloodborne
Sep 24, 2008

Lync is awful. I'm also annoyed there's no option that I can see to remove the timestamps from the chat window.

Truga
May 4, 2014
Lipstick Apathy
That all sounds _exactly_ like the issues I had with the previous versions of skype for linux. Coincidence?

Migishu
Oct 22, 2005

I'll eat your fucking eyeballs if you're not careful

Grimey Drawer

Truga posted:

That all sounds _exactly_ like the issues I had with the previous versions of skype for linux. Coincidence?

Probably not, I've had absolutely no problems with Skype for Windows, especially nothing like that.

Besides, Skype code is completely different than Lync code (and Skype was (mostly) coded by non-Microsoft people before the buyout so)

Roargasm
Oct 21, 2010

Hate to sound sleazy
But tease me
I don't want it if it's that easy

If you don't move the whole thing over to a Word document, don't forget to attach a PDF on how to unzip and double click a file. I've blasted out a .mht or two in my time and it confuses the poo poo out of people :sigh:

guppy
Sep 21, 2004

sting like a byob
"I know we put the me getting a new laptop on hold but I will need it sooner than later."

That is a real sentence written by the holder of a J.D. and an M.P.A. Also, I don't supply laptops, and the reason she wants a new one is that she somehow managed to hurt herself carrying a laptop through an airport because "It is entirely too heavy."

I don't even dislike this user, or most of my users. She's very nice. I just find them... puzzling.

Zemyla
Aug 6, 2008

I'll take her off your hands. Pleasure doing business with you!

guppy posted:

"I know we put the me getting a new laptop on hold but I will need it sooner than later."

That is a real sentence written by the holder of a J.D. and an M.P.A. Also, I don't supply laptops, and the reason she wants a new one is that she somehow managed to hurt herself carrying a laptop through an airport because "It is entirely too heavy."

I don't even dislike this user, or most of my users. She's very nice. I just find them... puzzling.

It's a lot more clear with more punctuation.

"I know we put the 'me getting a new laptop' on hold, but I will need it sooner than later."

guppy
Sep 21, 2004

sting like a byob
I know what she meant, it's just embarrassing writing from a ten year old, much less a holder of multiple postgraduate degrees.

KS
Jun 10, 2003
Outrageous Lumpwad
No tickets came in...

because my new employer doesn't have a ticketing system :stonk:

I'd love to get some recommendations for a small shop. We'd be starting with 5 agents. There's no infrastructure here, so it probably needs to be a cloud solution. Ideally I'd get ITIL-style incident/problem/change/asset management out of one tool, but that seems to really narrow down the field.

I came from a Service Now shop and would love to get Service Now Express in the door, but they have a $10k/year minimum, or 17 agents at $50/user/month. Ouch. I've also found FreshService, but so far they aren't answering their phones.

Anyone have recommendations for me, or experiences with FreshService to share? Budget's probably $5k/year at most, unless the added features justify the cost.

Dr. Arbitrary
Mar 15, 2006

Bleak Gremlin

KS posted:

No tickets came in...

because my new employer doesn't have a ticketing system :stonk:

I'd love to get some recommendations for a small shop. We'd be starting with 5 agents. There's no infrastructure here, so it probably needs to be a cloud solution. Ideally I'd get ITIL-style incident/problem/change/asset management out of one tool, but that seems to really narrow down the field.

I came from a Service Now shop and would love to get Service Now Express in the door, but they have a $10k/year minimum, or 17 agents at $50/user/month. Ouch. I've also found FreshService, but so far they aren't answering their phones.

Anyone have recommendations for me, or experiences with FreshService to share? Budget's probably $5k/year at most, unless the added features justify the cost.

Spiceworks is free. I don't know if there are other free solutions but that might be a good option if your budget is tight.

BaseballPCHiker
Jan 16, 2006

KS posted:

No tickets came in...

because my new employer doesn't have a ticketing system :stonk:

I'd love to get some recommendations for a small shop. We'd be starting with 5 agents. There's no infrastructure here, so it probably needs to be a butt solution. Ideally I'd get ITIL-style incident/problem/change/asset management out of one tool, but that seems to really narrow down the field.

I came from a Service Now shop and would love to get Service Now Express in the door, but they have a $10k/year minimum, or 17 agents at $50/user/month. Ouch. I've also found FreshService, but so far they aren't answering their phones.

Anyone have recommendations for me, or experiences with FreshService to share? Budget's probably $5k/year at most, unless the added features justify the cost.

The main recommendation your likely to get is Spiceworks which works well enough for a small shop and is free. You may also have access to Service Manager through your Microsoft Licensing agreement although that would be like killing a fly with a bazooka at that companies size.

Sickening
Jul 16, 2007

Black summer was the best summer.

KS posted:

No tickets came in...

because my new employer doesn't have a ticketing system :stonk:

I'd love to get some recommendations for a small shop. We'd be starting with 5 agents. There's no infrastructure here, so it probably needs to be a cloud solution. Ideally I'd get ITIL-style incident/problem/change/asset management out of one tool, but that seems to really narrow down the field.

I came from a Service Now shop and would love to get Service Now Express in the door, but they have a $10k/year minimum, or 17 agents at $50/user/month. Ouch. I've also found FreshService, but so far they aren't answering their phones.

Anyone have recommendations for me, or experiences with FreshService to share? Budget's probably $5k/year at most, unless the added features justify the cost.

Zendesk is what you want.

pr0digal
Sep 12, 2008

Alan Rickman Overdrive

Sickening posted:

Zendesk is what you want.

Seconded. I have 12 agents for under 5k/year and it's all in the cloud!

Been using it for 3+ years with no real complaints.

bull3964
Nov 18, 2000

DO YOU HEAR THAT? THAT'S THE SOUND OF ME PATTING MYSELF ON THE BACK.


Anyone have any opinion on BMC Track-It? We have local infrastructure so hosting it isn't an issue. We have a trial setup right now and it looks like it ticks all the boxes of having ticket management, asset management, and change management (all 3 of which we are sorely lacking in.)

Lord Dudeguy
Sep 17, 2006
[Insert good English here]

bull3964 posted:

BMC Track-It

Good for IT, bad if you want to customize it, really bad if other departments want a piece.

BMC Footprints is what happens when other departments want a piece, but won't tell you which piece. You can cross-departmentalize tickets and heavily customize/create automated workflows, but only if the departments use similar fields/keys.

"But my department is special!" and then it all falls to poo poo.

GreenNight
Feb 19, 2006
Turning the light on the darkest places, you and I know we got to face this now. We got to face this now.

Worked here 12 years. No ticketing system. Pretty nice.

kensei
Dec 27, 2007

He has come home, where he belongs. The Ancient Mariner returns to lead his first team to glory, forever and ever. Amen!


Lord Dudeguy posted:

Good for IT, bad if you want to customize it, really bad if other departments want a piece.

BMC Footprints is what happens when other departments want a piece, but won't tell you which piece. You can cross-departmentalize tickets and heavily customize/create automated workflows, but only if the departments use similar fields/keys.

"But my department is special!" and then it all falls to poo poo.

I am in the middle of deploying a new install of FootPrints 12 as a 'clean slate' with no legacy crap from the old special snowflake workspaces. We've boiled it down to 4 main workgroups in alignment with ITIL, but there are a bunch of ticket types in some of them. The ability to have a single pane of glass is great, and the different forms in the same workspace is awesome.

I really like the level of customization, but the having to create everything, and I mean everything is a little tedious.

bull3964
Nov 18, 2000

DO YOU HEAR THAT? THAT'S THE SOUND OF ME PATTING MYSELF ON THE BACK.


Lord Dudeguy posted:

Good for IT, bad if you want to customize it, really bad if other departments want a piece.

BMC Footprints is what happens when other departments want a piece, but won't tell you which piece. You can cross-departmentalize tickets and heavily customize/create automated workflows, but only if the departments use similar fields/keys.

"But my department is special!" and then it all falls to poo poo.

It'll just be for IT. It will only be used by 4 techs (including myself.) We have an office of about 120ish users/computers and so far have just been using an email group for end user request. It would just be better if they could submit them to a system instead for better visibility. That workload is honestly pretty light. However, on the production end of things, we are the ones managing our SaaS platform and need a bit more organization with things like change management. Right now our bug tracking system is doing double duty tracking setup and maintenance tasks and it really isn't suited for it.

Our end user client support is already through Kayako, so there's no intention at all for this system to be used cross departments.

Thanks Ants
May 21, 2004

#essereFerrari


As said, Zendesk. Kayako and JIRA Service Desk get honourable mentions.

EAT THE EGGS RICOLA
May 29, 2008

Thanks Ants posted:

As said, Zendesk. Kayako and JIRA Service Desk get honourable mentions.

I really like Jira, but it's going to be too expensive if they want users to have accounts and be able to comment on/track issues. If they use it just for IT internally and have less than 10 users it'll be $10/month hosted though.

KS
Jun 10, 2003
Outrageous Lumpwad
So if I go with Zendesk, is there a recommended product to integrate with it to do asset management? Anyone used Panorama9 or SAManage?

Sickening
Jul 16, 2007

Black summer was the best summer.

KS posted:

So if I go with Zendesk, is there a recommended product to integrate with it to do asset management? Anyone used Panorama9 or SAManage?

Be wary, all the ones I think that have integration are expensive as gently caress. As important as asset tracking is, the prices I saw weren't even reasonable for any small business.

Rawrbomb
Mar 11, 2011

rawrrrrr
Deskpro is way cheaper and (imo) better than zendesk, and the deskpro guys are all super awesome.

Sickening
Jul 16, 2007

Black summer was the best summer.

Rawrbomb posted:

Deskpro is way cheaper and (imo) better than zendesk, and the deskpro guys are all super awesome.

Way cheaper than zendesk? Is it free or something? I can't imagine any reputable software being cheaper than zendesk for 5 agents.

Rawrbomb
Mar 11, 2011

rawrrrrr

Sickening posted:

Way cheaper than zendesk? Is it free or something? I can't imagine any reputable software being cheaper than zendesk for 5 agents.

No, not cheaper at the entry level, but I was doing cost comparison about 2 years ago now for it, though we needed the enterprise/plus area. I didn't realize they were offering cheaper plans. I still have major issues with zendesk otherwise.

FISHMANPET
Mar 3, 2007

Sweet 'N Sour
Can't
Melt
Steel Beams

bull3964 posted:

It'll just be for IT. It will only be used by 4 techs (including myself.) We have an office of about 120ish users/computers and so far have just been using an email group for end user request.

That sounds like a lot of techs for only 120 people. Are the 5 of you in charge of the entire infrastructure or just the end user support? Either way sounds like an awful lot of man power.

luminalflux
May 27, 2005



EAT THE EGGS RICOLA posted:

I really like Jira, but it's going to be too expensive if they want users to have accounts and be able to comment on/track issues. If they use it just for IT internally and have less than 10 users it'll be $10/month hosted though.

Isn't that what Jira Service Desk fixes? Pay per agent with unlimited customers.

Adbot
ADBOT LOVES YOU

Ahdinko
Oct 27, 2007

WHAT A LOVELY DAY

bull3964 posted:

BMC Track-It?

I've never personally used it, but I sat next to a team of 6 first line guys who used it. They hated it with a passion and were so much happier about ticketing when I replaced it with Hornbill's Supportworks.

  • Locked thread