BookStack for IT Documentation

[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.

[black3dynamite]

@jaredbusch said in BookStack for IT Documentation:

@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.

When using WYSIWYG for your page editor, click on source code
and add this code. It also works when using Markdown too.

## collapsible markdown?

<details><summary>CLICK ME</summary>
<p>
Hello World
</p>
</details>

Source: https://gist.github.com/joyrexus/16041f2426450e73f5df9391f7f7ae5f#collapsible-markdown