[Sugar-devel] Introduction and review request of GSoC Proposal:
Frederick Grose
fgrose at gmail.com
Mon Mar 26 09:31:43 EDT 2018
On Mon, Mar 26, 2018 at 2:10 AM, James Cameron <quozl at laptop.org> wrote:
> I don't know. I don't have administrator rights on the Wiki. Hope
> Walter or someone else can answer. Meanwhile, I've been replacing
> migrated pages with links to the new location, so that old links don't
> break.
>
This method should be preferred. It is easy and effective, doesn't
destroy history, and points toward where you want people to look.
>
> On Mon, Mar 26, 2018 at 11:31:49AM +0530, Rudra Sadhu wrote:
> > thanks James for the assessment.
> >
> > I've successfully migrated a few of the pages from [1]https://
> > wiki.sugarlabs.org/go/Activities to GitHub
> > Find the pull request at [2]https://github.com/
> godiard/help-activity/pull/38
> >
> > and now, the wiki-pages needs to be deprecated.
> > As to delete a page from the wiki, an user needs 'administrators' rights,
> >
> > thus,
> > Some possible ways to delete the pages are:
> > 1. create a bot account with restricted permissions which can delete
> pages(my
> > preferred choice)
> > 2. for a temporary period grant delete rights to me
> > 3. someone trusted deletes the pages
> > 4. something else and better (please suggest)
> >
> > It may not be convenient to delete the pages manually as there will be
> > thousands of those(including extra images/files attached to the pages)
> for the
> > 345 pages to be migrated
> > All of the deletion is preferred to be done by a script (which
> uses [3]https://
> > www.mediawiki.org/wiki/API:Delete), under close supervision
> > Do not worry, no damage(if at all) will be permanent; since it is
> possible to
> > always recover pages deleted by an user with 'administrators' rights.
> Read [4]
> > https://www.mediawiki.org/wiki/Help:Deletion_and_undeletion
> >
> > Please recommend the desired course of action
> >
> > thanks,
> > Rudra Sadhu
> >
> > On Mon, Mar 26, 2018 at 10:41 AM, James Cameron <[5]quozl at laptop.org>
> wrote:
> >
> > Thanks, I've reviewed your updated proposal.
> >
> > My assessment of project impact;
> >
> > Originally documentation was separate because we had non-coding
> > developers and tool chains that varied by type of developer. Now we
> > use GitHub the tool chains are combined.
> >
> > With the project as described, documentation will be concentrated in
> > the source code repository for an activity, reducing ongoing
> > maintenance.
> >
> > We have less active Wiki contributors than we ever did, and in the
> > current threat environment a Wiki requires significant monitoring and
> > administration; we recently lost some system administrators and
> gained
> > new ones; using GitHub allows us to outsource system administration.
> >
> > On Sun, Mar 25, 2018 at 08:06:49PM +0530, Rudra Sadhu wrote:
> > > Thanks James, Carlos, Gonzalo and everyone for the insights
> > >
> > > Your inputs helped a lot, and I've updated my proposal accordingly.
> > > A lot of important stuff was added such as the working the Help
> Activity,
> > > keeping check on the activity bundle sizes and completing the
> > miscellaneous
> > > section.
> > >
> > > The proposal is available at [1][6]https://wiki.sugarlabs.org/go/
> > Summer_of_Code/
> > > 2018/attentive_migration_of_wiki_activity_pages_to_git
> > > I've also shared the same via the GSoC dashboard
> > > Please read, most importantly the 'About Project' section
> > >
> > > Let me know of the stuff I should add/remove/update to better
> justify the
> > > task.
> > >
> > > also It would help, if someone volunteers to answer the impact of
> this
> > project
> > > required to be filled in as an answer in the 'Project and the
> Community'
> > > section
> > >
> > > Thanks
> > > Rudra Sadhu
> > >
> > > On Wed, Mar 21, 2018 at 5:46 PM, Rudra Sadhu <[2][7]
> rdrsadhu at gmail.com>
> > wrote:
> > >
> > > Thanks James,
> > > the resources you mentioned were really helpful.
> > >
> > > I went ahead to migrate a few of the pages by the guidelines
> you
> > described.
> > > Find the Pull Request here: [3][8]https://github.
> com/sugarlabs/
> > activity-abacus
> > > /pull/13
> > >
> > > Please review
> > >
> > > On Wed, Mar 21, 2018 at 4:32 AM, James Cameron <[4][9]
> > quozl at laptop.org> wrote:
> > >
> > > On IRC #sugar Vipul Gupta asked;
> > >
> > > <vipulgupta2048> Hey, in the Activity task of migration.
> We need
> > to
> > > migrate content from activities page to their Githubs or
> their
> > git
> > > pages.
> > >
> > > <vipulgupta2048> ?
> > >
> > > <vipulgupta2048> Please clarify which one is it. Some
> pages don't
> > have
> > > the links of their repository
> > >
> > > <vipulgupta2048> The organisations is not uniform. I have
> > included
> > > this in my proposal too.
> > >
> > > <Quozl_> vipulgupta2048: need to write a program that will
> > migrate
> > > content from [5][10]wiki.sugarlabs.org activities page to
> > respective GitHub
> > > repository README.md files, yet without duplicating what is
> > there, and
> > > without duplicating user documentation in the
> help-activity, see
> > > recent posts to sugar-devel@ discussing the issue.
> > >
> > > <Quozl_> vipulgupta2048: did you get the above? if not,
> i'll
> > have to
> > > write a mail.
> > >
> > > My recent post is quoted below and can be found in the
> mailing
> > list
> > > archives.
> > >
> > > On Wed, Mar 14, 2018 at 06:04:02PM +1100, James Cameron
> wrote:
> > > > G'day Rudra,
> > > >
> > > > Thanks for being at the meeting earlier, and for your
> proposal.
> > > >
> > > > A project for GSoC 2013 added context sensitive help, or
> user
> > > > documentation, to the Sugar desktop, with alt+shift+h
> key.
> > > >
> > > > It works with the Help activity. Metadata in the Help
> activity
> > links
> > > a
> > > > subject activity to a markdown source file, which is
> converted
> > to
> > > HTML
> > > > and rendered in a tiny browser.
> > > >
> > > > Many of these source files came from the Wiki pages of
> > activities,
> > > and
> > > > have been updated since then.
> > > >
> > > > Please review and integrate the Help activity into your
> > proposal; for
> > > > instance;
> > > >
> > > > - avoid duplicating user documentation into activity
> > repositories,
> > > > because that would make for unncessary maintenance
> burden,
> > or;
> > > >
> > > > - move some of the Help activity files into activity
> > repositories and
> > > > provide a way to update the Help activity from the
> subject
> > > > activities.
> > > >
> > > > Please review the discussion on these two pull requests;
> > > >
> > > > [6][11]https://github.com/sugarlabs/activity-abacus/
> pull/12
> > > > [7][12]https://github.com/sugarlabs/sugar-docs/pull/137
> > > >
> > > > And then ask any questions to clarify, thanks.
> > > >
> > > > --
> > > > James Cameron
> > > > [8][13]http://quozl.netrek.org/
> > >
> > > --
> > > James Cameron
> > > [9][14]http://quozl.netrek.org/
> > >
> > > References:
> > >
> > > [1] [15]https://wiki.sugarlabs.org/go/Summer_of_Code/2018/
> attentive_
> > migration_of_wiki_activity_pages_to_git
> > > [2] mailto:[16]rdrsadhu at gmail.com
> > > [3] [17]https://github.com/sugarlabs/activity-abacus/pull/13
> > > [4] mailto:[18]quozl at laptop.org
> > > [5] [19]http://wiki.sugarlabs.org/
> > > [6] [20]https://github.com/sugarlabs/activity-abacus/pull/12
> > > [7] [21]https://github.com/sugarlabs/sugar-docs/pull/137
> > > [8] [22]http://quozl.netrek.org/
> > > [9] [23]http://quozl.netrek.org/
> >
> > --
> > James Cameron
> > [24]http://quozl.netrek.org/
> >
> > References:
> >
> > [1] https://wiki.sugarlabs.org/go/Activities
> > [2] https://github.com/godiard/help-activity/pull/38
> > [3] https://www.mediawiki.org/wiki/API:Delete
> > [4] https://www.mediawiki.org/wiki/Help:Deletion_and_undeletion
> > [5] mailto:quozl at laptop.org
> > [6] https://wiki.sugarlabs.org/go/Summer_of_Code/
> > [7] mailto:rdrsadhu at gmail.com
> > [8] https://github.com/sugarlabs/activity-abacus
> > [9] mailto:quozl at laptop.org
> > [10] http://wiki.sugarlabs.org/
> > [11] https://github.com/sugarlabs/activity-abacus/pull/12
> > [12] https://github.com/sugarlabs/sugar-docs/pull/137
> > [13] http://quozl.netrek.org/
> > [14] http://quozl.netrek.org/
> > [15] https://wiki.sugarlabs.org/go/Summer_of_Code/2018/attentive_
> migration_of_wiki_activity_pages_to_git
> > [16] mailto:rdrsadhu at gmail.com
> > [17] https://github.com/sugarlabs/activity-abacus/pull/13
> > [18] mailto:quozl at laptop.org
> > [19] http://wiki.sugarlabs.org/
> > [20] https://github.com/sugarlabs/activity-abacus/pull/12
> > [21] https://github.com/sugarlabs/sugar-docs/pull/137
> > [22] http://quozl.netrek.org/
> > [23] http://quozl.netrek.org/
> > [24] http://quozl.netrek.org/
>
> --
> James Cameron
> http://quozl.netrek.org/
> _______________________________________________
> Sugar-devel mailing list
> Sugar-devel at lists.sugarlabs.org
> http://lists.sugarlabs.org/listinfo/sugar-devel
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.sugarlabs.org/archive/sugar-devel/attachments/20180326/f24731b0/attachment-0001.html>
More information about the Sugar-devel
mailing list