Documentation March 22, 2017, 10:40:19 am Hello -I'm having a hard time finding documentation on things here, and instead of taking notes when I find it, I'd rather add it to your documentation for end users. I installed the GitHub Desktop, then cloned the wiki, but since I've never done anything with GitHub before, I'm lost already.I can see Elkarte.wiki in the left column of the GitHub window, with "Open in Explorer" which lets me open a file in TexPad, or Open in "Git Shell", which opens a shell window. (yikes!)Is there a way to see the existing pages and stubs in the GitHub Desktop window, or could you direct me to instructions on how to edit this?Thank you.
Re: Documentation Reply #1 – March 22, 2017, 08:52:04 pm Random thought: Would editing on the web interface be easier? https://github.com/elkarte/Elkarte/wikihttps://github.com/elkarte/Elkarte/wiki (Account on GitHub needed)
Re: Documentation Reply #2 – March 23, 2017, 03:32:08 am Quote from: live627 – March 22, 2017, 08:52:04 pmRandom thought: Would editing on the web interface be easier? https://github.com/elkarte/Elkarte/wiki (Account on GitHub needed)I'm not even sure if you can push to the wiki (never considered the option), the web interface is the was I do it. @billwill thank you very much! This is very, very needed!
Re: Documentation Reply #3 – March 23, 2017, 06:39:50 am I'll try the web interface and see if it is easier to understand. Thanks for the screenshot, live627.Hope my efforts are fruitful.
Re: Documentation Reply #4 – March 23, 2017, 03:56:06 pm Quote from: emanuele – March 23, 2017, 03:32:08 amI'm not even sure if you can push to the wiki (never considered the option), the web interface is the was I do it. You can, it's https://github.com/elkarte/Elkarte.wiki.git after all.
Re: Documentation Reply #5 – March 27, 2017, 08:47:06 am Hello -I've been experimenting with the online gh, and have a couple of questions: 1. Are screenshots an option? They make documentation much easier for the user to understand, and the documenter to make.2. If I want to create a new structure in an area, is there a "sandbox" area I can experiment with? I think for the user, it would be more accessible if features were listed according to what people want to accomplish rather than listing features and configurations and then they have to figure out which category of features what they want is in. For example instead of having permissions scattered among boards, groups, members, etc., there would be a category for permissions, and explain them all there, since they are so intertwined.3. When I edit something, does it just go out, or do you guys have a chance to make sure I'm accurate before the public can view it?I misspoke in my first post. I was assuming that the admins were the end users. I want to work on admin instead of end users at this point.
Re: Documentation Reply #6 – March 27, 2017, 01:11:39 pm 1. Yes, but I'm not sure if it can be sensibly done without Git, which a minor bummer I suppose. On the flipside, maybe larger images shouldn't be part of a Git repository in the first place and then it doesn't matter. Also I'm not sure if you and I (i.e., people without write access on the Elk repo) can push there. Still, a lot can be achieved using the GitHub online wiki alone.3. Not in the regular PR sense I don't think.
Re: Documentation Reply #7 – March 27, 2017, 03:40:27 pm 1. http://mikehadlow.blogspot.it/2014/03/how-to-add-images-to-github-wiki.html Yep, only from the cloned repo... 2. Not "really", but considering a sandbox, can simply be a namespace, we can decide anything under "sandbox" (i.e. https://github.com/elkarte/Elkarte/wiki/sandbox/Setup-Home ) is sandbox. Otherwise we can create a repo just for the sandbox of the wiki...3. Out immediately AFAIK. But that's okay, if you want to give an extra, just post here somewhere and someone can have a look.
Re: Documentation Reply #8 – March 28, 2017, 01:04:07 pm Thanks for the info. If I can add screenshots, I'll keep them as small as they can be viewed to avoid Frenzie's comment. Don't mistake my slowness in getting started for a lack of interest. My site is in shambles after I changed hosts, and most of the parts of it are not liking php 7, so I'm juggling a bit. I'll focus on getting the screenshots to work on GIT Hub and see how that goes.
Re: Documentation Reply #9 – March 28, 2017, 04:35:42 pm Quote from: billwill – March 28, 2017, 01:04:07 pmDon't mistake my slowness in getting started for a lack of interest. I appreciate your effort Elkarte needs a documentation
Re: Documentation Reply #11 – March 29, 2017, 02:32:55 am QuoteElkarte needs a documentationHow much is one documentation?
Modern, Free, Powerful