Lujeni / matterllo

Simple integration between Trello and Mattermost: send Trello activity notifications to Mattermost channels
MIT License
86 stars 25 forks source link

Trouble Following the Documentation #10

Closed michaelgrilo closed 7 years ago

michaelgrilo commented 8 years ago

Without having an extensive knowledge of Mattermost and/or Flask, the documentation has been very hard to follow. The trouble starts on requirements.html. No information is provided about installing pip; not too big of a deal. The generating an incoming webhook was easy enough. Then in the next section, it is not very clear what I will be doing with the Trello key and token.

Under settings.html, I'm at a loss as to what the first step is. I understand I need to generate a config file, but it is not clear to me where this file should be located and what it should be named (later on I see that it should be named config.yaml, but why not have this in the same place as the rest of the config information?).

I looked through all of the output of pip install matterllo and I just cannot sort out which directory any of this is supposed to be happening in.

Any help making the documentation easier to understand would be truly appreciated.

Lujeni commented 8 years ago

Hello,

Thanks for your feedback !

I wil try to summarize your issue and create a pull request with a check list to improve the documentation.

Lujeni commented 8 years ago

Hi,

I decided to create a real admin interface to facilitate the matterllo integration. #12 It's will be much easier to create the bridge between trello and mattermost.

I will update the documentation after this feature.

lifeboy commented 8 years ago

Is there progress with the admin interface? I too struggle to make sense of the installation process since I'm not a python developer. I suppose one can study all the background info to be able to understand what should be happening, but I really don't want to have to do that, I just would like to integrate mattermost with trello.

GhostLyrics commented 8 years ago

@lifeboy I've since updated the documentation on a few spots. I'd ask you kindly to state where things are not as easy as they could be and I'll try my best to improve there so @Lujeni can focus on coding.

Lujeni commented 8 years ago

@lifeboy Yep i am on it but i am a litle bit slow.

Another works for the ansible project take all my free time right now.

Feel free to ping me on IRC or another chat (choose one :)) for your installation.

Lujeni commented 7 years ago

Admin interface will be release this week.

Lujeni commented 7 years ago

I closed this issue. The complete refactoring is done.

Feel free to ping me if the setup is always a mess (i will re-open ths issue).