[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