Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Master #87

Merged
merged 9 commits into from Nov 10, 2015
Merged

Master #87

merged 9 commits into from Nov 10, 2015

Conversation

PeterWaher
Copy link
Contributor

Provided Definition, Introduction, Outline & info on bindings.

Added Definition & the beginning of an outline/disposition for the page.
Added an introduction to the communication protocols section, and gave
introductory explanations to different connection bindings available for
things.
@imaginator
Copy link
Contributor

Hi Peter,

Nice changes thanks for looking this.

I suggest that we keep the page to a brief introduction and then split out details like connection binding and other aspects to deeper level pages or point over to the wiki with a "learn more" link. We want to avoid hitting someone with a wall of text and keep the tone to a light "XMPP can help you solve your IoT problems" two or three paragraphs.

To give you and idea, the other pages in this category try to just give a high level overview for someone not familiar with XMPP.

And then provide links for someone who wants to explore more.

@PeterWaher
Copy link
Contributor Author

Ok. Thanks for input. It might be good to provide some overview with links. I'll continue to write in this one page document for now, just to keep everything in one place while writing, and when I get the disposition more or less sorted out, I can break text out into sub-pages. Is that OK? It's also easier to proofread that way, and to maintain an overview. But you're correct that a short introductory page as a first page is better.

@imaginator
Copy link
Contributor

Sub-pages would be great!

imaginator pushed a commit that referenced this pull request Nov 10, 2015
@imaginator imaginator merged commit 51b6072 into xsf:master Nov 10, 2015
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants