Re: Embedding Guide withdrawn?
Dylan Jay <djay-n0pU0XVUApFWk0Htik3J/[email protected]> Tue, 25 Feb 2014 18:00:04 -0800 (PST)
| Newsgroups | gmane.comp.web.zope.plone.website |
|---|---|
| Message-ID | <[email protected]> |
--===============0029104265045590668== Content-Type: multipart/alternative; boundary="----=_Part_218063_25323007.1393380004812" ------=_Part_218063_25323007.1393380004812 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit On 26 Feb 2014, at 4:40 am, Philip Kilner [via Plone] <ml-node+s293351n7570288h17-PKuAHvtXa09l57MIdRCFDg@public.gmane.org> wrote: > Hi Paul, > > On 25/02/14 16:14, Paul Roeland wrote: > > Don't be sad, much better documentation will be a reality soon ;-) > > > > I originally typed a much longer reply, but zapped it as it wasn't > especially positive. > > > And of course nothing is ever *lost*, if there's still valuable snippets > > in there that need to be revived they will be. All the info is > > retracted, not deleted... > > There was now just no peoplepower to sift through 9 years of old stuff > > to sort everything out, double-check, etcetera. > > > > Understood, and I understand that this is a case of "cobbler's > children's shoes", but I do worry about the impression that it gives of > Plone: - > > - Lots of what are essentially broken links in search results that point > to the Plone site. > > - Plone knowledge scattered across the web in such a way that is hard > for an outsider to evaluate which is most valuable, and which > potentially misleading which is one reason we decided to try and bring it into one place http://developer.plone.org/ > > - An uncomfortable message given that Plone is a system for managing > content, and we seem to have choked on the process of managing our /own/ > content, I think the answer is in the own words you use. Managing content is a process not just a technology. Plone is one technology that tries to make it easier but well managed content needs people and processes. Luckily we have a process. If you have documentation that others need and you have, go to http://developer.plone.org/, find the right place for it and click the button "edit this document". I guess we don't have a process of getting access to the retracted content so you can help merge it into the developer manual but I'm sure that members of the documentation team can get you a copy of that content should you volunteer to merge it. > > I know you know all this, that this is open source, and that I > can/should play a role in fixing it myself, but I just wanted to explain > what was behind the sad face. > > I've written a bunch of how-to docs for my clients which are currently > private - perhaps I should start publishing them, but each was written > for a fairly narrow use-case, and I'm not sure my approaches would be > considered "best practice"... If you fork the documentation and submit it, it will be reviewed before merge. Those who review it will let you know if it's not appropriate. If you are really unsure then email teh documentation list with the gist of your content. > > > > -- > > Regards, > > PhilK > > > e: [hidden email] - m: 07775 796 747 > > 'work as if you lived in the early days of a better nation' > - alasdair gray > > > > ------------------------------------------------------------------------------ > Flow-based real-time traffic analytics software. Cisco certified tool. > Monitor traffic, SLAs, QoS, Medianet, WAAS etc. with NetFlow Analyzer > Customize your own dashboards, set traffic alerts and generate reports. > Network behavioral analysis & security monitoring. All-in-one tool. > http://pubads.g.doubleclick.net/gampad/clk?id=126839071&iu=/4140/ostg.clktrk > _______________________________________________ > Plone-website mailing list > [hidden email] > https://lists.sourceforge.net/lists/listinfo/plone-website > The Wiki: http://plone.org/development/current/projects/WebsiteTeam > > > If you reply to this email, your message will be added to the discussion below: > http://plone.293351.n2.nabble.com/Embedding-Guide-withdrawn-tp7570248p7570288.html > To start a new topic under plone.org Web Site, email ml-node+s293351n293363h42-PKuAHvtXa09l57MIdRCFDg@public.gmane.org > To unsubscribe from plone.org Web Site, click here. > NAML -- View this message in context: http://plone.293351.n2.nabble.com/Embedding-Guide-withdrawn-tp7570248p7570289.html Sent from the plone.org Web Site mailing list archive at Nabble.com. ------=_Part_218063_25323007.1393380004812 Content-Type: text/html; charset=us-ascii Content-Transfer-Encoding: 7bit On 26 Feb 2014, at 4:40 am, Philip Kilner [via Plone] <<a href="/user/SendEmail.jtp?type=node&node=7570289&i=0" target="_top" rel="nofollow" link="external">[hidden email]</a>> wrote: <br/><div class='shrinkable-quote'><br/>> Hi Paul, <br/>> <br/>> On 25/02/14 16:14, Paul Roeland wrote: <br/>> > Don't be sad, much better documentation will be a reality soon ;-) <br/>> > <br/>> <br/>> I originally typed a much longer reply, but zapped it as it wasn't <br/>> especially positive. <br/>> <br/>> > And of course nothing is ever *lost*, if there's still valuable snippets <br/>> > in there that need to be revived they will be. All the info is <br/>> > retracted, not deleted... <br/>> > There was now just no peoplepower to sift through 9 years of old stuff <br/>> > to sort everything out, double-check, etcetera. <br/>> > <br/>> <br/>> Understood, and I understand that this is a case of "cobbler's <br/>> children's shoes", but I do worry about the impression that it gives of <br/>> Plone: - <br/>> <br/>> - Lots of what are essentially broken links in search results that point <br/>> to the Plone site. <br/>> <br/>> - Plone knowledge scattered across the web in such a way that is hard <br/>> for an outsider to evaluate which is most valuable, and which <br/>> potentially misleading </div><br/>which is one reason we decided to try and bring it into one place <a href="http://developer.plone.org/" target="_top" rel="nofollow" link="external">http://developer.plone.org/</a><br/><br/>> <br/>> - An uncomfortable message given that Plone is a system for managing <br/>> content, and we seem to have choked on the process of managing our /own/ <br/>> content, <br/><br/>I think the answer is in the own words you use. Managing content is a process not just a technology. Plone is one technology that tries to make it easier but well managed content needs people and processes. <br/>Luckily we have a process. If you have documentation that others need and you have, go to <a href="http://developer.plone.org/" target="_top" rel="nofollow" link="external">http://developer.plone.org/</a>, find the right place for it and click the button "edit this document". <br/><br/>I guess we don't have a process of getting access to the retracted content so you can help merge it into the developer manual but I'm sure that members of the documentation team can get you a copy of that content should you volunteer to merge it. <br/><br/>> <br/>> I know you know all this, that this is open source, and that I <br/>> can/should play a role in fixing it myself, but I just wanted to explain <br/>> what was behind the sad face. <br/>> <br/>> I've written a bunch of how-to docs for my clients which are currently <br/>> private - perhaps I should start publishing them, but each was written <br/>> for a fairly narrow use-case, and I'm not sure my approaches would be <br/>> considered "best practice"... <br/><br/>If you fork the documentation and submit it, it will be reviewed before merge. Those who review it will let you know if it's not appropriate. If you are really unsure then email teh documentation list with the gist of your content. <br/><br/><div class='shrinkable-quote'><br/>> <br/>> <br/>> <br/>> -- <br/>> <br/>> Regards, <br/>> <br/>> PhilK <br/>> <br/>> <br/>> e: [hidden email] - m: 07775 796 747 <br/>> <br/>> 'work as if you lived in the early days of a better nation' <br/>> - alasdair gray <br/>> <br/>> <br/>> <br/>> ------------------------------------------------------------------------------ <br/>> Flow-based real-time traffic analytics software. Cisco certified tool. <br/>> Monitor traffic, SLAs, QoS, Medianet, WAAS etc. with NetFlow Analyzer <br/>> Customize your own dashboards, set traffic alerts and generate reports. <br/>> Network behavioral analysis & security monitoring. All-in-one tool. <br/>> <a href="http://pubads.g.doubleclick.net/gampad/clk?id=126839071&iu=/4140/ostg.clktrk" target="_top" rel="nofollow" link="external">http://pubads.g.doubleclick.net/gampad/clk?id=126839071&iu=/4140/ostg.clktrk</a><br/>> _______________________________________________ <br/>> Plone-website mailing list <br/>> [hidden email] <br/>> <a href="https://lists.sourceforge.net/lists/listinfo/plone-website" target="_top" rel="nofollow" link="external">https://lists.sourceforge.net/lists/listinfo/plone-website</a><br/>> The Wiki: <a href="http://plone.org/development/current/projects/WebsiteTeam" target="_top" rel="nofollow" link="external">http://plone.org/development/current/projects/WebsiteTeam</a><br/>> <br/>> <br/>> If you reply to this email, your message will be added to the discussion below: <br/>> <a href="http://plone.293351.n2.nabble.com/Embedding-Guide-withdrawn-tp7570248p7570288.html" target="_top" rel="nofollow" link="external">http://plone.293351.n2.nabble.com/Embedding-Guide-withdrawn-tp7570248p7570288.html</a><br/>> To start a new topic under plone.org Web Site, email <a href="/user/SendEmail.jtp?type=node&node=7570289&i=1" target="_top" rel="nofollow" link="external">[hidden email]</a> <br/>> To unsubscribe from plone.org Web Site, click here. <br/>> NAML </div><br/> <br/><hr align="left" width="300" /> View this message in context: <a href="http://plone.293351.n2.nabble.com/Embedding-Guide-withdrawn-tp7570248p7570289.html">Re: Embedding Guide withdrawn?</a><br/> Sent from the <a href="http://plone.293351.n2.nabble.com/plone-org-Web-Site-f293363.html">plone.org Web Site mailing list archive</a> at Nabble.com.<br/> ------=_Part_218063_25323007.1393380004812-- --===============0029104265045590668== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline ------------------------------------------------------------------------------ Flow-based real-time traffic analytics software. Cisco certified tool. Monitor traffic, SLAs, QoS, Medianet, WAAS etc. with NetFlow Analyzer Customize your own dashboards, set traffic alerts and generate reports. Network behavioral analysis & security monitoring. All-in-one tool. http://pubads.g.doubleclick.net/gampad/clk?id=126839071&iu=/4140/ostg.clktrk --===============0029104265045590668== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline _______________________________________________ Plone-website mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/plone-website The Wiki: http://plone.org/development/current/projects/WebsiteTeam --===============0029104265045590668==--