Re: SDLC Documentation

Subject: Re: SDLC Documentation
From: Nina Barzgaran <nina -dot- barzgaran -at- barzgaran -dot- at>
To: Jason L <dotlogue -at- gmail -dot- com>
Date: Fri, 04 Nov 2022 17:28:15 +0100

Hello Jason,

your email is rather long and complex, at a first glance.

But reading closely this well-ordered explanation of what your are trying to face shows clear enough, I should think:
* You are doing fine!

* Basically, what is going on, is this, you said it yourself, really, just to state it once more clearly:
** There is a process already in place.
** This process has a sort of definition, albeit rouhgly, probably more in people's minds.
** Against that, a kind of template of such processes, the *Software Development Life Cycle Document*, is to be used.
** It shall help to do two things:
*** More clearly define what people *are* already doing.
*** Show the procedural steps that are missing in order to fulfill that document's requirements - and complete the document so it will make clear what's there - for the audit.

Again, I think, the basic idea is fine, you are gathering information, talking to people and planning of presenting your findings in clear, structured visuals and writing that help others 'see the light'. :)

Another piece of background might help: The whole 'life cycle' concept in IT-environments stems from the ITIL framework of IT-management and service procedures.
It was developed around the 1960s in Britain by government organizations because they repeatedly 'hit the wall' with their IT-infrastructure management.
I took the so-called (c)Foundation certificate but it's been quite a while now... so you might want to look up the basics.

Hope this helps!

All the best
Nina

Am 03.11.2022 23:52, schrieb Jason L:

Hello,

*TL;DR version: I need help developing an SDLC document that will help this
large healthcare IT company prepare for an external audit, and oh by the
way, I've never developed an SDLC from scratch. *

I am a contract technical writer and recently started working remotely for
a healthcare IT company. This is a large-ish company that has been gobbling
up other smaller IT companies, and one of those companies (a medical
credentialing company I will call RealDoc from now on) is the one I'm
tasked with helping.

As a whole, this company is going through the HITRUST audit certification
process (think NIST, SOC, HIPAA, etc), and they needed help with
documentation in the process. This is the third HITRUST process I've been a
part of, and I'd like to think I know enough to be helpful and even do some
BA work as well.

I came on board about three weeks ago, and initially they asked me to read
through and do some basic editing of their policies. This was the third or
fourth go around, so I didn't find many issues. There have been no daily
stands or even weekly meetings yet. I have not been given access to any
typical matrices that show audit requirements, gaps, exceptions, or who
owns those areas, etc.

After I finished the initial policy reviews, I had to poke and prod a bit
to find out what was next. The hiring manager said I needed to work with a
director of RealDoc and find out how I can help them with their SDLC
process. After some awkward meetings with product managers, the director
and back and forth emails, I've discovered RealDoc does not have an SDLC at
all - they are trying to create one from scratch. They had developed a
product team playbook and sent it to me, but it didn't really go into
things I expect to see in an SDLC (planning, requirements gathering,
development, quality assurance), but instead was focused on talking about
epics/user stories/features or bugs/issues. There were some basic Visio
diagrams that mapped out the different software development states.

As I said earlier, I'm communicating consistently with the RealDocs
director. I am hoping to get an idea from him about who I should have
meetings with - the SMEs, the respective leads for each application's qa,
devops, cloud, and release teams. My plan is to meet with them and have
them walk me through their parts of the SDLC process. And after that
probably create an outline, workflow diagram and go from there. I've been
googling SDLC document, but keep coming up with deliverables in the SDLC
like use cases, business requirements, design docs, test scripts, etc.

Do any of you have input on this? It seems overwhelming and vague right
now, and as I said, it's been hard to connect with stakeholders.

Thanks for your help.

-Jason
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | https://techwhirl.com

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as nina -dot- barzgaran -at- barzgaran -dot- at -dot-
To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | https://techwhirl.com

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


References:
SDLC Documentation: From: Jason L

Previous by Author: Re: SDLC Documentation
Next by Author: Re: SDLC Documentation
Previous by Thread: RE: SDLC Documentation
Next by Thread: Re: SDLC Documentation


What this post helpful? Share it with friends and colleagues:


Sponsored Ads