Sean Lange (12/26/2012)

---

ScottPletcher (12/26/2012)

---

Sean Lange (12/26/2012)

---

ScottPletcher (12/26/2012)

---

Sean Lange (12/26/2012)

---

SQL_Kills (12/26/2012)

---

Hi,

First of all I hope everyone has had a good Christmas!

Just wanted to know if anyone documents there table using MS_Description? I'm struggling to think how much detail I should put on there so the end user understands what this table entails. I would also like to say which ssis package populates this table or if this gets populated by other source of etl process.

Just need an example I can look at and I can then use that best example from now on.

Thanks

End users should not be seeing your table definitions. This type of documentation is for technical people (dbas, sql devs, etc). People that can view the table definitions. That being said, I don't find it to be very useful because you have to dig around to even realize the information is there.

I somewhat disagree. I quite agree that most end-users should not be able to get table documentation, per se, since they should not be aware of tables. Typically, however, a few selected "power users" can use this info.

I generate documentation into the extended attributes, although I store the original documentation in a database. I can then generate to other formats also (html, xml, etc.).

Sounds to me like we didn't disagree at all. 🙂 We both said it is for a few "power users".

I would be curious how you use the extended properties to help generate documentation. I have never really found the extended properties very useful. Do you use them to generate help files / technical documentation?

I do it the other way around: I store the documentation in a table, and use that table to generate the extended properties.

However, I also have code that allows me to take changes made to the extended properties and put them back into the documentation table. Sometimes it's easier to make quick changes there, or I notice something while I'm using the documentation and so correct it right there.

I also encourage end users to do their own documentation for various apps, "screens", etc.. Often they can phrase things so that they, and others in that specific job/function, understand them better. I leverage the existing documentation system, right now thru the SSMS extended attributes editor (not great, but at least they have some type of GUI 😉 ). Later hopefully through Word and other more powerful means.

I, too, never found extended properties that useful either before, particularly since I had to code them by hand :crying:.

But now I have procs that cover all that, I have to admit I rather like being able to use extended properties to get a quick description of a table column immediately from SSMS; when, for example, I can't remember what a code of "S" means for a particular column (even when I created that column originally :w00t:).

The documentation table has flags that indicate who, by role, should see which comments: DBA-only, developer admin, developer, power user, any user, etc..

I'm sure it's not optimal, but it gives me something in the way of documentation; in particular, it allows me to document as the table is created, when I know the most about it.

I know what you mean about something like an "S". 😉

If you have any details about you use the extended properties (code, etc) I would be interested in reading it. It sounds like a pretty interesting way to go about it. I am always open to new ideas. It may be too that what you have is difficult to share because it sounds like a number of things that make up the whole picture. Hmmm...sounds like an article in the making. 😛