last day (92 days later) » 

8:23 PM
room topic changed to SQL and Database Product Docs: Review and Editing of the SQL and database docs - SQL Server, MySQL, Oracle, and whatnot (no tags)
I'd like us to use this room to discuss both the SQL docs and the Docs for each database product MySQL, SQL Server, oracle, postgresql, etc.
The SQL docs are getting a bit messy and unwieldy and was brought up on MSO
31
Q: Chaos building in SQL-section of documentation

Stefan SteigerThere is chaos building in the SQL-section of the documentation. People are adding samples from various (incompatible) SQL-dialects, and there is no mentioning which SQL-dialect it is. For example: String functions LEN and DATALENGTH, which are T-SQL exclusively. in example database a sam...

 
it's not gonna be easy to navigate there, though
 
IMO, I'd think we'd want the SQL docs to cover things that are universal. I'm worried that we're going to be creating docs that have examples which won't work on every platform and will become very difficult for users.
@Lamak I agree, which is why we need the community to discuss it and work towards cleaning it up, etc
 
so, we should move the examples that are database specific?, or try to improve them to make them universal?
 
@Lamak that's up for discussion which is why we're here. For example, we had a topic request under SQL for DBCC - that's SQL Server only so that should exist only in the SQL Server Docs
 
@bluefeet okay, I promise that I'll make an effort there
 
8:34 PM
But when you look at the Example Databases it uses syntax for MySQL (auto_increment). If I'm a user of SQL Server and I want to test that it's going to fail
So on stuff like that - maybe we use headers/etc to show that example is for MySQL and then we need to add an example for SQL Server.
 
sounds fine to me
 
Another thing I've seen is we have new docs proposals for different versions of SQL Server, that's what the versioning in docs is for. I'm not sure we need docs for SQL Server 2005, SQL Server 2008, etc we should be using the SQL Server docs and then use versioning to identify items.
 
@bluefeet I'm not familiar with the versioning part of the docs
 
@Lamak when the original docs are created (there currently is a Hello World) - on that you can add different versions of the product - see this page and scroll to the bottom - stackoverflow.com/documentation/sql-server/236/…
then when a topic is created you can select the versions - see here - stackoverflow.com/documentation/sql-server/703/…
 
I see
 
8:44 PM
Then when something changes with a version, you can create a topic that is specific for it
 
@bluefeet then obviously there shouldn't be new docs proposals for different version of SQL Server
 
@Lamak that's my feeling as well
 
though it does gets challenging with more general topics such as SQL
 
which is partly why I wanted to create a room to discuss some of these challenges.
If we can fix, discuss some of these things before it gets too big, that'd be ideal
 
right
it's a good idea
 
9:00 PM
If you're reviewing docs and run across something that you're not sure about, post it in here and it can be discussed.
 
@bluefeet ok, will do
 

  last day (92 days later) »