We must organize the doc

Community
21

ok i give up :slight_smile:

22

Nono, don’t give up man :slight_smile: you know… I work always for you.

Where there’s no way to have a solution that can satisfy everyone, my philosophy is:

  • Try it for a while – live with it
  • Gather basic feedback
  • Adjust it over time based on feedback from living with it

So, @stephdl would you mind to create a new dokuwiki istance? NethServer only - let me know if you need a hand for VM or you can do it on your own.
Organize it as you like, @Jim Jim’s suggestions sound good for me.

Let’s try and look what happens :slight_smile:

Just two requests from me:

  • No force people to create yet another account, using GitHub auth at least (see auth extension)
  • Add Markdown support, so we can import existing Discourse Howto and in case smoothly export data on other wiki/destinations

What do you think?

2 Likes
23

@stephdl @alefattorini @jim and the other guys,
If i can help with something please let me know.
You have my support on this

Best regards
Bogdan

24

Whatever you decide to try, I will follow that lead. If it will be GitHub, then please link to some detailed howto. I am no devver at all (understatement) and absolutely not familiar with GitHub or ‘GitHub-like’ solutions. I know you can pull and fork, but what that does… beats me… So I’m afraid I will need a detailed step by step to get that working…

I will start reading this: https://guides.github.com/activities/hello-world/

3 Likes
25

Rob we are working on it :smile:

2 Likes
26

I’d like to add: The output Github gives through ReadTheDocs is quite usefull. A big PLUS is that you can easily downloud the content in several different formats. I only hope that it will be ‘easy enough’ so everybody can participate easily producing documentation.

1 Like
27

Just created a quick and dirty instance of dokuwiki: http://www.nethserver.org/dokuwiki/
This is NOT the final version, but its’ only for testing purpose.
Github (oAuth) authentication plugin is installed but not configured.

I also created and admin account for @stephdl.
Please try and share your thoughts. :smile:

4 Likes
28

I can have a go, but it will never the work of just one man…that’s not possible.

I tried to start something, visible at http://mirror.de-labrusse.fr/doku.php, does the layout can be reused ?

29

It would be awesome if discourse accounts and wiki accounts can be synced…

1 Like
30

It’s fair, as a matter of fact it’s a team work, Docs Team? Would you mind to coordinate it?
A lot of members requested a wiki, now it’s time to roll up our sleeves: @AbsyntH @stephdl @Jim @zamboni @robb @dz00te @apradoc @Ctek

31

You’re right! This is just a test instance, so anybody can play with it without damage you instance :wink:
If the community will decide this is the right path, we will create a fool-proof instance managed by multiple people :smile:

It seems Discourse isn’t an oAuth provider, so this is not possible but you can use gihtub (or facebook, yahoo, google and even dockerhub) to access both.

1 Like
32

add me… happy to help out here

/edit added myself (created an account on dokuwiki)

1 Like
33

Looks not easy, there’s an API


I can share the API but I don’t know how to use it on dokuwiki auth extension
34

i started with my daughter on my arm, not easy to use the keyboard…

of course the side bar is just a draft, please shout…

@anybody, please can you write a warm start page -> http://www.nethserver.org/dokuwiki/doku.php?id=start

2 Likes
35

I made a start for the front page of the wiki. However, I think it should be a wellthought format. So maybe some discussion about what, how and who etc should take place before anything is added to the wiki.

1 Like
36

yes…for now it is just a draft, no important data should be added…

37

@giacomo, give me a chance to pay you a beer at the fossdem, you are my hero.

can you do a slight modification to enlarge the display —> https://geekeries.de-labrusse.fr/?p=2810

in short in /lib/tpl/dokuwiki/style.ini do

-  __site_width__ = "75em" ; @ini_site_width ;
+ __site_width__ = "100em" ; @ini_site_width ;

that needs to be tested, this is my default display…of course I love my 27’’

1 Like
38

Only one? :stuck_out_tongue:

Modification done: it’s much much better now!

Say hello to your daughter, maybe she will get used to fall asleep with the sound of typing on the keyboard :smile:

4 Likes
39

Can you have a look to http://www.nethserver.org/dokuwiki/doku.php?id=start and browse the sidebar…please shout what is wrong

I installed two plugins with a good popularity see the help page…what about of this, do you know better plugin ?

Any ideas are welcome

40

I had already retagged the existing howtos
What I do? How I do?

  • All installations and installations on virtual system or cloud system are “Deployment”
  • All Howto relationned with Firewall, VPN, Proxy, Share and AD are “CoreSystem”
  • All Howto relationned with other application are " Application"
  • There’s few “community”
  • Video tutorial are tagged…“video”
  • Other stuff are “devcorner”

Depending the audience, the skill, the screenshots or command line difficulty, there’s tag " GeneralAudience", “intermediate”, “Advanced”.

In general, I kept all the existing tags… And there’s “draft”, please, could you take a look to enhance all Drafts Howtos.

1 Like