I noticed that the documentation for new developers was outdated and scattered throughout different places, so here's a little update on what I've being doing to merge those pages. The "Submitting Patches" page was completely outdated [1], so I ported the more complete and up-to-date content from the source file docs/SubmittingPatches [2] to Confluence and merged it into the more recent "Pull Requests" page [3]. As the Pull Requests page was already long enough, I moved some of the new content to new pages: * Commit Message Guidelines - https://freeswitch.org/confluence/display/FREESWITCH/Commit+Message+Guidelin... * New Modules - https://freeswitch.org/confluence/display/FREESWITCH/New+Modules I also noticed there were two different sections with look-alike content: "Developers" and "Community > Contributing Code". I moved everything from the former (including sub-pages) to the latter. Next actions: * Remove https://freeswitch.org/confluence/display/FREESWITCH/Submitting+Patches (I don't seem to have permission to do that) * Remove https://freeswitch.org/confluence/display/FREESWITCH/Installing+Git - either Brian or Areski tagged it for deletion * Remove [2] entirely (to avoid duplicate content), or just point it to [3]. [1] https://freeswitch.org/confluence/pages/viewpage.action?pageId=6587641 [2] https://freeswitch.org/stash/projects/FS/repos/freeswitch/browse/docs/Submit... [3] https://freeswitch.org/confluence/display/FREESWITCH/Pull+Requests Feedback would be appreciated. -- Humberto Diógenes
Great work... Keep it up. On Mon, Jan 5, 2015 at 1:39 PM, Humberto Diógenes <hdiogenes@gmail.com> wrote:
I noticed that the documentation for new developers was outdated and scattered throughout different places, so here's a little update on what I've being doing to merge those pages.
The "Submitting Patches" page was completely outdated [1], so I ported the more complete and up-to-date content from the source file docs/SubmittingPatches [2] to Confluence and merged it into the more recent "Pull Requests" page [3].
As the Pull Requests page was already long enough, I moved some of the new content to new pages: * Commit Message Guidelines - https://freeswitch.org/confluence/display/FREESWITCH/Commit+Message+Guidelin... * New Modules - https://freeswitch.org/confluence/display/FREESWITCH/New+Modules
I also noticed there were two different sections with look-alike content: "Developers" and "Community > Contributing Code". I moved everything from the former (including sub-pages) to the latter.
Next actions: * Remove https://freeswitch.org/confluence/display/FREESWITCH/Submitting+Patches (I don't seem to have permission to do that) * Remove https://freeswitch.org/confluence/display/FREESWITCH/Installing+Git - either Brian or Areski tagged it for deletion * Remove [2] entirely (to avoid duplicate content), or just point it to [3].
[1] https://freeswitch.org/confluence/pages/viewpage.action?pageId=6587641 [2] https://freeswitch.org/stash/projects/FS/repos/freeswitch/browse/docs/Submit... [3] https://freeswitch.org/confluence/display/FREESWITCH/Pull+Requests
Feedback would be appreciated.
-- Humberto Diógenes
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
-- *Brian West* brian@freeswitch.org *Twitter: @FreeSWITCH , @briankwest* http://www.freeswitchbook.com http://www.freeswitchcookbook.com *T:*+19184209001 | *F:*+19184209002 | *M:*+1918424WEST (9378) *iNUM:*+883 5100 1420 9001 | *ISN:*410*543 | *Skype:*briankwest
This is EXCELLENT! Thank you very much for clarifying the duplicated pages. I'm in the middle of sorting out 2 large pages that have both been edited independently, yet contain largely the same content. It's a nightmare. L Bote From: freeswitch-docs-bounces@lists.freeswitch.org [mailto:freeswitch-docs-bounces@lists.freeswitch.org] On Behalf Of Humberto Diógenes Sent: Monday, 05 January, 2015 14:39 To: freeswitch-docs@lists.freeswitch.org Subject: [Freeswitch-docs] Developer Docs I noticed that the documentation for new developers was outdated and scattered throughout different places, so here's a little update on what I've being doing to merge those pages. The "Submitting Patches" page was completely outdated [1], so I ported the more complete and up-to-date content from the source file docs/SubmittingPatches [2] to Confluence and merged it into the more recent "Pull Requests" page [3]. As the Pull Requests page was already long enough, I moved some of the new content to new pages: * Commit Message Guidelines - https://freeswitch.org/confluence/display/FREESWITCH/Commit+Message+Guidelin... * New Modules - https://freeswitch.org/confluence/display/FREESWITCH/New+Modules I also noticed there were two different sections with look-alike content: "Developers" and "Community > Contributing Code". I moved everything from the former (including sub-pages) to the latter. Next actions: * Remove https://freeswitch.org/confluence/display/FREESWITCH/Submitting+Patches (I don't seem to have permission to do that) * Remove https://freeswitch.org/confluence/display/FREESWITCH/Installing+Git - either Brian or Areski tagged it for deletion * Remove [2] entirely (to avoid duplicate content), or just point it to [3]. [1] https://freeswitch.org/confluence/pages/viewpage.action?pageId=6587641 [2] https://freeswitch.org/stash/projects/FS/repos/freeswitch/browse/docs/Submit... [3] https://freeswitch.org/confluence/display/FREESWITCH/Pull+Requests Feedback would be appreciated. -- Humberto Diógenes
Great job! Yes I did mark this page as "TO BE DELETED", as to my opinion installing Git should not be covered by our FS confluence, plus this page https://freeswitch.org/confluence/display/FREESWITCH/Tips+for+using+Git already points to the official documentation on installing Git. I don't have permission to delete it, so Brian/Bote if you can delete it and agree please go ahead. On Tue, Jan 6, 2015 at 1:34 AM, Bote Man <bote_radio@botecomm.com> wrote:
This is EXCELLENT! Thank you very much for clarifying the duplicated pages.
I'm in the middle of sorting out 2 large pages that have both been edited independently, yet contain largely the same content. It's a nightmare. L
Bote
*From:* freeswitch-docs-bounces@lists.freeswitch.org [mailto: freeswitch-docs-bounces@lists.freeswitch.org] *On Behalf Of *Humberto Diógenes *Sent:* Monday, 05 January, 2015 14:39 *To:* freeswitch-docs@lists.freeswitch.org *Subject:* [Freeswitch-docs] Developer Docs
I noticed that the documentation for new developers was outdated and scattered throughout different places, so here's a little update on what I've being doing to merge those pages.
The "Submitting Patches" page was completely outdated [1], so I ported the more complete and up-to-date content from the source file docs/SubmittingPatches [2] to Confluence and merged it into the more recent "Pull Requests" page [3].
As the Pull Requests page was already long enough, I moved some of the new content to new pages:
* Commit Message Guidelines - https://freeswitch.org/confluence/display/FREESWITCH/Commit+Message+Guidelin...
* New Modules - https://freeswitch.org/confluence/display/FREESWITCH/New+Modules
I also noticed there were two different sections with look-alike content: "Developers" and "Community > Contributing Code". I moved everything from the former (including sub-pages) to the latter.
Next actions:
* Remove https://freeswitch.org/confluence/display/FREESWITCH/Submitting+Patches (I don't seem to have permission to do that)
* Remove https://freeswitch.org/confluence/display/FREESWITCH/Installing+Git - either Brian or Areski tagged it for deletion
* Remove [2] entirely (to avoid duplicate content), or just point it to [3].
[1] https://freeswitch.org/confluence/pages/viewpage.action?pageId=6587641
[2] https://freeswitch.org/stash/projects/FS/repos/freeswitch/browse/docs/Submit...
[3] https://freeswitch.org/confluence/display/FREESWITCH/Pull+Requests
Feedback would be appreciated.
--
Humberto Diógenes
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
-- Kind regards, /Areski ---- Arezqui Belaid, <areski@gmail.com> Founder at Star2Billing (www.star2billing.com) Tel: +34650784355 Twitter: http://twitter.com/areskib LinkedIn: http://www.linkedin.com/in/areski
OK, I have deleted the pages that Humberto marked to be deleted. Not to worry, Confluence holds them in a trash bin in case of incorrect deletion so they could be recovered if necessary. I didn't read very carefully last night about the request to delete; it is amazing what a cup of coffee can do! Thanks! Bote From: freeswitch-docs-bounces@lists.freeswitch.org [mailto:freeswitch-docs-bounces@lists.freeswitch.org] On Behalf Of Areski Sent: Tuesday, 06 January, 2015 05:18 To: FreeSWITCH Docs Team Subject: Re: [Freeswitch-docs] Developer Docs Great job! Yes I did mark this page as "TO BE DELETED", as to my opinion installing Git should not be covered by our FS confluence, plus this page https://freeswitch.org/confluence/display/FREESWITCH/Tips+for+using+Git already points to the official documentation on installing Git. I don't have permission to delete it, so Brian/Bote if you can delete it and agree please go ahead. On Tue, Jan 6, 2015 at 1:34 AM, Bote Man <bote_radio@botecomm.com> wrote: This is EXCELLENT! Thank you very much for clarifying the duplicated pages. I'm in the middle of sorting out 2 large pages that have both been edited independently, yet contain largely the same content. It's a nightmare. L Bote From: freeswitch-docs-bounces@lists.freeswitch.org [mailto:freeswitch-docs-bounces@lists.freeswitch.org] On Behalf Of Humberto Diógenes Sent: Monday, 05 January, 2015 14:39 To: freeswitch-docs@lists.freeswitch.org Subject: [Freeswitch-docs] Developer Docs I noticed that the documentation for new developers was outdated and scattered throughout different places, so here's a little update on what I've being doing to merge those pages. The "Submitting Patches" page was completely outdated [1], so I ported the more complete and up-to-date content from the source file docs/SubmittingPatches [2] to Confluence and merged it into the more recent "Pull Requests" page [3]. As the Pull Requests page was already long enough, I moved some of the new content to new pages: * Commit Message Guidelines - https://freeswitch.org/confluence/display/FREESWITCH/Commit+Message+Guidelin... * New Modules - https://freeswitch.org/confluence/display/FREESWITCH/New+Modules I also noticed there were two different sections with look-alike content: "Developers" and "Community > Contributing Code". I moved everything from the former (including sub-pages) to the latter. Next actions: * Remove https://freeswitch.org/confluence/display/FREESWITCH/Submitting+Patches (I don't seem to have permission to do that) * Remove https://freeswitch.org/confluence/display/FREESWITCH/Installing+Git - either Brian or Areski tagged it for deletion * Remove [2] entirely (to avoid duplicate content), or just point it to [3]. [1] https://freeswitch.org/confluence/pages/viewpage.action?pageId=6587641 [2] https://freeswitch.org/stash/projects/FS/repos/freeswitch/browse/docs/Submit... [3] https://freeswitch.org/confluence/display/FREESWITCH/Pull+Requests Feedback would be appreciated. -- Humberto Diógenes _______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs -- Kind regards, /Areski ---- Arezqui Belaid, <areski@gmail.com> Founder at Star2Billing (www.star2billing.com) Tel: +34650784355 Twitter: http://twitter.com/areskib LinkedIn: http://www.linkedin.com/in/areski
participants (4)
-
Areski
-
Bote Man
-
Brian West
-
Humberto Diógenes