{"action":"created","issue":{"url":"https://api.github.com/repos/Cacti/documentation/issues/4","repository_url":"https://api.github.com/repos/Cacti/documentation","labels_url":"https://api.github.com/repos/Cacti/documentation/issues/4/labels{/name}","comments_url":"https://api.github.com/repos/Cacti/documentation/issues/4/comments","events_url":"https://api.github.com/repos/Cacti/documentation/issues/4/events","html_url":"https://github.com/Cacti/documentation/issues/4","id":343199834,"node_id":"MDU6SXNzdWUzNDMxOTk4MzQ=","number":4,"title":"Wiki Formatting?  (Taken from Cacti repo)","user":{"login":"netniV","id":9052188,"node_id":"MDQ6VXNlcjkwNTIxODg=","avatar_url":"https://avatars0.githubusercontent.com/u/9052188?v=4","gravatar_id":"","url":"https://api.github.com/users/netniV","html_url":"https://github.com/netniV","followers_url":"https://api.github.com/users/netniV/followers","following_url":"https://api.github.com/users/netniV/following{/other_user}","gists_url":"https://api.github.com/users/netniV/gists{/gist_id}","starred_url":"https://api.github.com/users/netniV/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/netniV/subscriptions","organizations_url":"https://api.github.com/users/netniV/orgs","repos_url":"https://api.github.com/users/netniV/repos","events_url":"https://api.github.com/users/netniV/events{/privacy}","received_events_url":"https://api.github.com/users/netniV/received_events","type":"User","site_admin":false},"labels":[{"id":615064551,"node_id":"MDU6TGFiZWw2MTUwNjQ1NTE=","url":"https://api.github.com/repos/Cacti/documentation/labels/help%20wanted","name":"help wanted","color":"128A0C","default":true},{"id":615064554,"node_id":"MDU6TGFiZWw2MTUwNjQ1NTQ=","url":"https://api.github.com/repos/Cacti/documentation/labels/question","name":"question","color":"cc317c","default":true}],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":16,"created_at":"2018-07-20T18:09:16Z","updated_at":"2018-09-03T21:15:21Z","closed_at":null,"author_association":"CONTRIBUTOR","body":"This issue is a continuation of [Cacti Issue #924](https://github.com/Cacti/cacti/issues/924) with a copy of that issues details below\r\n<hr>\r\n\r\n### @jpartain89 posted on  23 Aug 2017:\r\nWhat language are the wiki pages supposed to be coded in.... \r\n\r\nBecause there's a ton of `//` items and `;` at the beginning of lines.... \r\n\r\nThese don't exactly make sense, especially if you're trying to use MarkDown, as other parts of the docs ARE appropriately using... \r\n\r\nIf there is a need to change the Wiki pages/Documentation to a specific language, I'd be more than happy to help, but in need of a singular language/format. \r\n<hr>\r\n\r\n### @cigamit commented on 23 Aug 2017:\r\nThanks. We are currently reviewing the whole Wiki/Documentation effort.\r\n\r\nCan you post a few links of those pages?\r\n<hr>\r\n\r\n### @devsibwarra commented on 23 Aug 2017:\r\n@cigamit https://github.com/Cacti/cacti/wiki/Linux-Installation is one example.  Looks like a spliced mix of MediaWiki and MarkDown was used on that page\r\n<hr>\r\n\r\n### @cigamit commented on 28 Aug 2017:\r\nOkay, noted. Right now we are working on a refresh to the documentation plan. We have created a documentation repository, and we will be breaking the rather large manual.md into categories that can be displayed in the various GUI sections of Cacti.\r\n\r\nFor example, we will have a documentation section on Presets, Presets > VDEF, Presets > Colors, Presets > GPrint Presets, Presets > Data Source Profiles, etc.\r\n\r\nIf you have suggestions for Chapters, we would welcome them. Pull requests there are also welcomed. My first thought would to be to align the markdown files similar to how our HTML documentation reads, but to add these various sections so that we can link to them inside the GUI.\r\n<hr>\r\n\r\n### @jpobeda commented on 28 Aug 2017:\r\nWhatever you decide, please do it thinking on multi language so people can help with translations in the future.\r\n<hr>\r\n\r\n### @cigamit commented on 29 Aug 2017:\r\nTony would like help first updating the documentation in English, then we will create independent language directories such as 'en', etc. He please use the Wiki on the documentation repo to share thoughts on chapters. Then, if you can help with English first, we will then move to other languages.\r\n\r\nPull requests will be the way we take updates as with everything else.\r\n<hr>\r\n\r\n### @jpobeda commented on 30 Aug 2017:\r\nI'm happy to help.\r\n<hr>\r\n\r\n### @ronytomen commented on 11 Sep 2017:\r\nGood to know!\r\n\r\nI'm going to move this issue to the documentation repository.\r\n\r\nOk, I can't move issues.. lol\r\n\r\nIt will stay here to remind me.\r\n\r\n<hr>\r\n\r\nI've now recreated this as a new issue.  And will be closing/locking the old one."},"comment":{"url":"https://api.github.com/repos/Cacti/documentation/issues/comments/418193793","html_url":"https://github.com/Cacti/documentation/issues/4#issuecomment-418193793","issue_url":"https://api.github.com/repos/Cacti/documentation/issues/4","id":418193793,"node_id":"MDEyOklzc3VlQ29tbWVudDQxODE5Mzc5Mw==","user":{"login":"netniV","id":9052188,"node_id":"MDQ6VXNlcjkwNTIxODg=","avatar_url":"https://avatars0.githubusercontent.com/u/9052188?v=4","gravatar_id":"","url":"https://api.github.com/users/netniV","html_url":"https://github.com/netniV","followers_url":"https://api.github.com/users/netniV/followers","following_url":"https://api.github.com/users/netniV/following{/other_user}","gists_url":"https://api.github.com/users/netniV/gists{/gist_id}","starred_url":"https://api.github.com/users/netniV/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/netniV/subscriptions","organizations_url":"https://api.github.com/users/netniV/orgs","repos_url":"https://api.github.com/users/netniV/repos","events_url":"https://api.github.com/users/netniV/events{/privacy}","received_events_url":"https://api.github.com/users/netniV/received_events","type":"User","site_admin":false},"created_at":"2018-09-03T21:15:21Z","updated_at":"2018-09-03T21:15:21Z","author_association":"CONTRIBUTOR","body":"We need to make sure we aren't missing any vital information from the old manual.  Things have changed from what was written so that will also need to be updated too.  For example, the variables were a little out of date, so I updated them whilst I was copying the missed info.\r\n\r\nAs for sections, I don't think we need too many more.  If you think some reordering needs doing, suggest away as nothing is set in stone right now.   I would suggest picking a section at a time to update so it's not just one massive update.\r\n\r\nIt may be easier to do things in the following order:\r\n\r\n- Pick a section and create a branch in your repo\r\n   - Review titles for uniqueness\r\n   - Review content for missing info/tables/images\r\n   - Review links to other documentation pages\r\n      - If a section hasn't been updated with info that is needed, make a note to update the URL later\r\n      - Don't update the outdated section until later\r\n   - Update info where possible\r\n   - Submit a pr, rinse and repeat\r\n\r\nThis will allow others to review individual pull requests without affecting others, so if we hold one back, we can still submit others. "}}
{"actor":{"display_login":"netniV"}}