From e556a8127ab976725729b3221d82db990e9a27b9 Mon Sep 17 00:00:00 2001 From: Sean Allred Date: Tue, 2 Dec 2014 11:27:52 -0500 Subject: Update README with some basic instructions. Notes: `sx-tab' should not need to be required. The necessary functions should be auto-loaded. --- README.org | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) (limited to 'README.org') diff --git a/README.org b/README.org index df8d907..db75b90 100644 --- a/README.org +++ b/README.org @@ -40,11 +40,28 @@ To install the development version, follow the usual steps: - Clone this repository - Add this directory to your ~load-path~ - Issue ~(require 'sx)~ +- Issue ~(require 'sx-tab)~ This should give you access to the only entry point function at the moment, ~sx-tab-frontpage~. Eventually, this package will be available on MELPA. +** Some Basic Controls +- =RET= :: interact with things under point (collapse headers, visit + links, etc.) +- =TAB= :: go to next element +- =n= :: go to next section +- =p= :: go to previous section +- =j= :: go to next question, viewing it +- =k= :: go to previous question, viewing it +- =v= :: visit a question on the browser +- =w= :: copy things under point (usually a url) +- =e= :: edit +- =a= :: answer +- =c= :: comment +- =u= :: vote up +- =d= :: vote down + * Contributing Please help contribute! Doing any of the following will help us immensely: - [[https://github.com/vermiculus/sx.el/issues/new][Open an issue]] -- cgit v1.2.3 From 9c6385498246bfa7e446ae875424e24681a20c29 Mon Sep 17 00:00:00 2001 From: Sean Allred Date: Tue, 2 Dec 2014 19:57:41 -0500 Subject: Refill to 80 characters --- README.org | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) (limited to 'README.org') diff --git a/README.org b/README.org index db75b90..245719d 100644 --- a/README.org +++ b/README.org @@ -4,9 +4,9 @@ [[https://gitter.im/vermiculus/sx.el?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge][https://badges.gitter.im/Join Chat.svg]] [[https://www.waffle.io/vermiculus/sx.el][https://badge.waffle.io/vermiculus/sx.el.svg]] -SX will be a full featured Stack Exchange mode for GNU Emacs 24+. -Using the official API, we aim to create a more versatile experience -for the Stack Exchange network within Emacs itself. +SX will be a full featured Stack Exchange mode for GNU Emacs 24+. Using the +official API, we aim to create a more versatile experience for the Stack +Exchange network within Emacs itself. * Features - ~sx-tab-frontpage~ :: @@ -69,10 +69,9 @@ Please help contribute! Doing any of the following will help us immensely: - [[https://gitter.im/vermiculus/sx.el][Suggest a package or library in our Chat on Gitter]] (or just hang out =:)=) - Spread the word! -For a better view of all of the open issues, take a look at our lovely -[[http://www.waffle.io/vermiculus/sx.el][Waffle board]]. Feel free to take the torch on anything in =backlog= or -=ready=. If you have thoughts on any other issues, don't hesitate to -chime in! +For a better view of all of the open issues, take a look at our lovely [[http://www.waffle.io/vermiculus/sx.el][Waffle +board]]. Feel free to take the torch on anything in =backlog= or =ready=. If you +have thoughts on any other issues, don't hesitate to chime in! * Resources - [[http://www.gnu.org/software/emacs/][GNU Emacs]] @@ -85,3 +84,7 @@ it. - [[file:resources/emacs.svg][Emacs icon]] - [[file:resources/stackexchange.svg][Stack Exchange icon]] +* COMMENT Local Variables +# Local Variables: +# fill-column: 80 +# End: -- cgit v1.2.3 From a0556c38eb39d66fcde2a7e09eaa9f1ed7e3a7e6 Mon Sep 17 00:00:00 2001 From: Sean Allred Date: Tue, 2 Dec 2014 19:58:02 -0500 Subject: More complete README --- README.org | 67 ++++++++++++++++++++++++-------------------------------------- 1 file changed, 26 insertions(+), 41 deletions(-) (limited to 'README.org') diff --git a/README.org b/README.org index 245719d..9194a10 100644 --- a/README.org +++ b/README.org @@ -9,31 +9,28 @@ official API, we aim to create a more versatile experience for the Stack Exchange network within Emacs itself. * Features -- ~sx-tab-frontpage~ :: - List questions on a StackExchange site. -- Viewing Posts :: - - Use =jknp= to open questions from within ~list-questions~; use - =RET= to move focus. - - Use =v= to open the object at point in your browser. - - Use =TAB= to fold questions and answers. - - Use =RET= to open a link at point. - - Use =:= to switch sites. - - Vote up and down with =u= and =d=. +** Viewing Questions +View questions with one of the ~sx-tab-~ commands. These translate to the +different 'tabs' that you can view on the official site. Implemented tabs +include: +- =frontpage= :: The default front page of questions. +- =newest= :: Newest questions first. +- =topvoted= :: Highest-voted questions first. +- =hot= :: Questions with the most views, answers, and votes over the last few + days. +- =week= :: Questions with the most views, answers, and votes this week. +- =month= :: Questions with the most views, answers, and votes this month. +The meaning of these tabs hopefully needs no explanation, but the official +behavior is given as a tooltip on any site in the StackExchange network. -** Planned -- Archiving questions for offline access -- Browsing and favoriting networks -- Advanced searching -- Writing questions, answers, and comments (with source code in its - native major mode) -- Notifications -- Reputation reporting -- ... +Each of these opens up a list of questions. Switch sites with =:=. Navigate +this list of questions with =jk= or =np=. =jk= will also view the question in a +separate buffer. =v= will visit the question in your browser where =w= will +simply copy a link. Upvote and downvote with =u= and =d=. =RET= will take you +to the question buffer, where =RET= on headlines will expand and collapse each +section. Add comments with =c=. -Have a feature in mind that isn't on the list? Submit a pull request -to add it to the list! If you want to discuss it first, pop in our -Gitter chatroom (badge above) -- someone will be around shortly to -talk about it. +As always, =C-h m= is the definitive resource for the functions of this mode. * Installation To install the development version, follow the usual steps: @@ -41,26 +38,14 @@ To install the development version, follow the usual steps: - Add this directory to your ~load-path~ - Issue ~(require 'sx)~ - Issue ~(require 'sx-tab)~ -This should give you access to the only entry point function at the -moment, ~sx-tab-frontpage~. +This should give you access to the ~sx-tab-~ functions (the main entry points at +this time). -Eventually, this package will be available on MELPA. +If you are going to be doing any asking / answering / commenting / upvoting / +downvoting / /etc./, you must use ~sx-authenticate~ to provide SX with an +authentication token to act on your behalf. -** Some Basic Controls -- =RET= :: interact with things under point (collapse headers, visit - links, etc.) -- =TAB= :: go to next element -- =n= :: go to next section -- =p= :: go to previous section -- =j= :: go to next question, viewing it -- =k= :: go to previous question, viewing it -- =v= :: visit a question on the browser -- =w= :: copy things under point (usually a url) -- =e= :: edit -- =a= :: answer -- =c= :: comment -- =u= :: vote up -- =d= :: vote down +Eventually, this package will be available on MELPA. * Contributing Please help contribute! Doing any of the following will help us immensely: -- cgit v1.2.3 From 539debfc6c07b1cd9bf478452869f36583877eca Mon Sep 17 00:00:00 2001 From: Sean Allred Date: Tue, 2 Dec 2014 20:16:36 -0500 Subject: Add CONTRIBUTING.org --- CONTRIBUTING.org | 23 +++++++++++++++++++++++ README.org | 4 +++- 2 files changed, 26 insertions(+), 1 deletion(-) create mode 100644 CONTRIBUTING.org (limited to 'README.org') diff --git a/CONTRIBUTING.org b/CONTRIBUTING.org new file mode 100644 index 0000000..46fcf13 --- /dev/null +++ b/CONTRIBUTING.org @@ -0,0 +1,23 @@ +If you need help, search the issue tracker to see if anyone has asked +your question before. If it hasn't, a good place to ask first is our +chat room on [[https://gitter.im/vermiculus/sx.el][Gitter]]. Opening an issue is welcome of course, but chat +will likely be faster for you. If a code change needs to be made, an +issue can be written up as necessary. + +Have a great idea for SX? Again, discuss it on [[https://gitter.im/vermiculus/sx.el][Gitter]] first! Don't +limit ideas to mimicking the official website, either -- this is +Emacs; we should take advantage of its abilities. + +To see what we're working on /right now/, check out our [[http://www.waffle.io/vermiculus/sx.el][Waffle board]]. +If you would like to contribute, feel free to take on anything in the +=ready= column (which translates to the =ready= label in GitHub +issues). These are issues which have been discussed enough to provide +a good idea of what should be done. Issues in =backlog= are either +still under discussion or simply are in the backlog. + +Of course, the greatest gift you can give to SX is a good word. Star +the project on GitHub, mention it to others who would use it in your +StackExchange chat rooms (as always, be courteous and respectful), and +use it yourself. + +Enjoy! diff --git a/README.org b/README.org index 9194a10..460ba34 100644 --- a/README.org +++ b/README.org @@ -48,7 +48,7 @@ authentication token to act on your behalf. Eventually, this package will be available on MELPA. * Contributing -Please help contribute! Doing any of the following will help us immensely: +Please help contribute! Doing any of the following will help us immensely: - [[https://github.com/vermiculus/sx.el/issues/new][Open an issue]] - [[https://github.com/vermiculus/sx.el/pulls][Submit a pull request]] - [[https://gitter.im/vermiculus/sx.el][Suggest a package or library in our Chat on Gitter]] (or just hang out =:)=) @@ -58,6 +58,8 @@ For a better view of all of the open issues, take a look at our lovely [[http:// board]]. Feel free to take the torch on anything in =backlog= or =ready=. If you have thoughts on any other issues, don't hesitate to chime in! +See also =CONTRIBUTING.org=. + * Resources - [[http://www.gnu.org/software/emacs/][GNU Emacs]] - [[https://api.stackexchange.com/docs][Stack Exchange API v2.2]] -- cgit v1.2.3