BookStack for IT Documentation

[Alex Sage]

How would you break up the data? Books, Chapters, Pages?

[black3dynamite]

I like how Citrix XenServer guide is set up.
https://docs.citrix.com/content/dam/docs/en-us/xenserver/xenserver-7-0/downloads/xenserver-7-0-administrators-guide.pdf

And also NetworkDNA documentations
https://www.itnetworkdocs.com/networkdna/

[JaredBusch]

• Book = Client
  • Page = High level client info
  • Chapter = One per client site (ie Site A)
    • Page = Various pages for details
  • Chapter = User Documentation
    • Page = Various user guides specific to the client (ie how to setup email on your BYOD with specific server names for client)
  • Chapter = IT Documentation
    • Page = Various Guide for IT processes specific to the client

[black3dynamite]

@JaredBusch
That's an awesome way of using bookstack.

[JaredBusch]

First Example entered by my coworker

[Alex Sage]

@jaredbusch Nice!

I really like being able to copy and paste images

[JaredBusch]

someone add tags

[Obsolesce]

@aaronstuder said in BookStack for IT Documentation:

@jaredbusch Nice!

I really like being able to copy and paste images

You can copy and paste images in there?

[Obsolesce]

Can you control who has access to what?

[black3dynamite]

@tim_g said in BookStack for IT Documentation:

Can you control who has access to what?

I remember that you can create roles and set permissions to books, chapters, and pages.

[Obsolesce]

@black3dynamite said in BookStack for IT Documentation:

@tim_g said in BookStack for IT Documentation:

Can you control who has access to what?

I remember that you can create roles and set permissions to books, chapters, and pages.

Does it have a built in user permission control or does it need local users?

[JaredBusch]

@tim_g said in BookStack for IT Documentation:

@black3dynamite said in BookStack for IT Documentation:

@tim_g said in BookStack for IT Documentation:

Can you control who has access to what?

I remember that you can create roles and set permissions to books, chapters, and pages.

Does it have a built in user permission control or does it need local users?

[JaredBusch]

# General auth
AUTH_METHOD=standard

# Social Authentication information. Defaults as off.
GITHUB_APP_ID=false
GITHUB_APP_SECRET=false
GOOGLE_APP_ID=false
GOOGLE_APP_SECRET=false
OKTA_BASE_URL=false
OKTA_APP_ID=false
OKTA_APP_SECRET=false
TWITCH_APP_ID=false
TWITCH_APP_SECRET=false
GITLAB_APP_ID=false
GITLAB_APP_SECRET=false
GITLAB_BASE_URI=false

# External services such as Gravatar and Draw.IO
DISABLE_EXTERNAL_SERVICES=false

# LDAP Settings
LDAP_SERVER=false
LDAP_BASE_DN=false
LDAP_DN=false
LDAP_PASS=false
LDAP_USER_FILTER=false
LDAP_VERSION=false

[Alex Sage]

@tim_g Correct.

[black3dynamite]

Is there a way to stop showing previews?
Is there a way to collapse text in Bookstack using markdown?

[stacksofplates]

Is anyone actually using this?

[Obsolesce]

@stacksofplates said in BookStack for IT Documentation:

Is anyone actually using this?

I think JB is due to some clients needing a WYSIWYG editor.

[NashBrydges]

@stacksofplates said in BookStack for IT Documentation:

Is anyone actually using this?

I've fully transitioned to this for the same reasons @JaredBusch did. Easier for users.

[JaredBusch]

@black3dynamite said in BookStack for IT Documentation:

Is there a way to stop showing previews?
Is there a way to collapse text in Bookstack using markdown?

Never looked.
I do not know of any markdown commands to do that.

[stacksofplates]

@nashbrydges said in BookStack for IT Documentation:

@stacksofplates said in BookStack for IT Documentation:

Is anyone actually using this?

I've fully transitioned to this for the same reasons @JaredBusch did. Easier for users.

Oh ok. Ya if you need users to do something then that makes sense.