Revision history for RefactoringPages


Revision [12762]

Last edited on 2013-03-03 08:26:02 by MorganAdmin
Additions:
[[http://c2.com/cgi/wiki?WikiEssence Wiki Essence]] on C2.com: Frames the process of writing and refactoring to create wiki knowledge as the essence of wiki.>>=====RefactoringPages=====
Deletions:
[[http://c2.com/cgi/wiki?WikiEssence Wiki Essence]]: Frames the process of writing and refactoring to create wiki knowledge as the essence of wiki.>>=====RefactoringPages=====


Revision [12560]

Edited on 2013-02-23 15:46:46 by MorganAdmin
Additions:
[just getting started on this. Need to collect.]
Deletions:
''working on this part'' mcm


Revision [8583]

Edited on 2010-02-21 09:34:56 by MorganAdmin
Additions:
===== Techniques for Refactoring =====
''working on this part'' mcm
Deletions:
=== Techniques for Refactoring ===
''still working on this part''


Revision [8582]

Edited on 2010-02-21 09:33:23 by MorganAdmin
Additions:
probably will become a separate page or set of pages.
ties into EgoManiaMakesDifficultyToWiki and other pages on self and collective.
needs a page on alternative rhetorical moves to agreeing or disagreeing, distinguishing between holding an opinion that is personal (I like blue jeans) and so falls outside of discussion, and forming an opinion on a public matter (Conservatism is good for the country) and so falls inside discussion.
=== Make a list of topics ===
Start here. Work through the thread to isolate the topics, list them, perhaps reorganize the thread so the topics follow.
=== Summarize and develop the topics ===
In the role of refactorer, stand back, be neutral, review the topics and the positions the threaders presented. This is not controversial.
Deletions:


Revision [8370]

Edited on 2010-02-08 05:35:19 by MorganAdmin
Additions:
=== Refactoring and PagePatterns ===
Deletions:
=== Refactoring and PagePattern s ===


Revision [6606]

Edited on 2009-02-09 13:49:36 by MorganAdmin
Additions:
===Refactoring from Summary ===
I have a demo page on this: DemoPageRettbergAsAStartingPoint
An accurate summary will bring out and isolate topics which can be developed as WikiWords. Part of the move is to reorganize the topics from the structure of the original chapter or paper into something more synthetic: that is refactoring.


Revision [2936]

Edited on 2007-12-26 13:37:25 by MorganAdmin
Additions:
=== Refactoring and PagePattern s ===
CategoryWiki CategoryWikiHandbook
Deletions:
=== Refactoring and PagePatterns ===
CategoryWiki CategoryWritingWithAWiki


Revision [2874]

Edited on 2007-12-26 12:22:41 by MorganAdmin
Additions:
CategoryWiki CategoryWritingWithAWiki
Deletions:
CategoryWiki


Revision [1647]

Edited on 2007-02-21 07:57:06 by MorganAdmin
Additions:
''still working on this part''

Start with Wiki:RefactoringWikiPages at C2. This page presents techniques and heuristics for refactoring (Wiki:ConvertThreadModeToDocumentMode, Wiki:RefactorByRenaming...) and techniques for designing and presenting the page. We can add to these and adapt them for use on this wiki.
Deletions:
Start with Wiki:RefactoringWikiPages at C2. This page presents techniques and heuristics for refactoring (Wiki:ConvertThreadModeToDocumentMode, Wiki:RefactorByRenaming...) and techniques for designing and presenting the page. We can add to these and adapt them for use on this wiki.


Revision [1646]

Edited on 2007-02-21 07:56:17 by MorganAdmin
Additions:
Re-working a passage to make it easier to understand (change the signal to noise, bring out structures in ideas, make it mean more than it meant before) means changing its meaning. We know that. And we know that refactoring favors some stylistic moves over others. We know that, too. We know that RefactoringIsProblematic. But we refactor anyway.
Deletions:
''Re-working a passage to make it easier to understand (change the signal to noise, bring out structures in ideas, make it mean more than it meant before) means changing its meaning. We know that. And we know that refactoring favors some stylistic moves over others. We know that, too. We know that RefactoringIsProblematic. But we refactor anyway.''


Revision [1645]

Edited on 2007-02-21 07:55:50 by MorganAdmin
Additions:
[[http://c2.com/cgi/wiki?WikiEssence Wiki Essence]]: Frames the process of writing and refactoring to create wiki knowledge as the essence of wiki.>>=====RefactoringPages=====
Deletions:
- [[http://c2.com/cgi/wiki?WikiEssence Wiki Essence]]: Frames the process of writing and refactoring to create wiki knowledge as the essence of wiki.>>=====RefactoringPages=====


Revision [1644]

Edited on 2007-02-21 07:55:36 by MorganAdmin
Additions:
- [[http://c2.com/cgi/wiki?WikiEssence Wiki Essence]]: Frames the process of writing and refactoring to create wiki knowledge as the essence of wiki.>>=====RefactoringPages=====
While pages develop or evolve as contributers return to them, read them, edit, add, or reorganize them, //refactoring// is a conscientious technique for developing them.
=== Refactoring and Revising ===
Pages can be developed initially in the shuttling between ThreadMode or DocumentMode. //Refactoring// is a kind of revision, but where composition teachers may see revision as changing meaning, "refactoring a Wiki page [means] making it easier to read without changing its meaning" (Wiki:WhyRefactorWikiPages).
''Re-working a passage to make it easier to understand (change the signal to noise, bring out structures in ideas, make it mean more than it meant before) means changing its meaning. We know that. And we know that refactoring favors some stylistic moves over others. We know that, too. We know that RefactoringIsProblematic. But we refactor anyway.''
Refactoring is a matter of finding and making explicit an organizational pattern in the ideas of the ThreadMode exchange. It has the main purpose of making the latent, implicit, possible meanings explicit, reified enough to become a whole - a whole which can in turn be responded to, developed further, on another page, from another perspective.
Refactoring is synthesis. On WardsWiki, it's described this way:
Replace a thread mode conversation with a monolog that says the same thing and preserving as much of the original text as possible. Change the 1st person singular to 1st or 3rd person plural. Remove the inline attributions and put them at the end under "Contributors." It is understood that individual authors may not have chosen the exact words used; that we have a consensus and hence probably compromises. [[http://c2.com/cgi/wiki?ConvertThreadModeToDocumentMode]]
This is important in refactoring, but it is hard to do correctly. You need to synthesize the discussion in a way that is acceptable to most of the participants. Sometimes a discussion comes to an end, at which time it is easier to summarize it, but there is less motivation to do so. Discussions most need to be summarized when they get long, which usually means there are a lot of different opinions, making them hard to summarize. [http://c2.com/cgi/wiki?ConvertThreadModeToDocumentMode]
Suppose I refactor a conversation and I (unknowingly, of course) get it wrong. The topic itself will show up in ChangeSummary and RecentChanges. There are good odds that one of the experts on the subject will read it and correct it. [http://c2.com/cgi/wiki?ConvertThreadModeToDocumentMode]
Refactoring is an editor's game. Wanna be an editor? Learn to refactor. There's gonna be a place for expert refactorers in the new economy.
''This section needs development. Not sure where it's going yet.''
Start with Wiki:RefactoringWikiPages at C2. This page presents techniques and heuristics for refactoring (Wiki:ConvertThreadModeToDocumentMode, Wiki:RefactorByRenaming...) and techniques for designing and presenting the page. We can add to these and adapt them for use on this wiki.
Deletions:
* http://c2.com/cgi/wiki?WikiEssence Wiki Essence: Frames the process of writing and refactoring to create wiki knowledge as the essence of wiki.>>=====RefactoringPages=====
While pages develop or evolve as contributers return to them, read them, edit, add, or reorganize them, ''refactoring'' is a conscientious technique for developing them.
=== Refactoring and revising ===
Pages can be developed initially in the shuttling between ThreadMode or DocumentMode. ''Refactoring'' is a kind of revision, but where comp/rhet types might see revision as changing meaning, "refactoring a Wiki page [means] making it easier to read without changing its meaning" (Wiki:WhyRefactorWikiPages).
: ''Re-working a passage to make it easier to understand (change the signal to noise, bring out structures in ideas, make it mean more than it meant before) means changing its meaning. We know that. And we know that refactoring favors some stylistic moves over others. We know that, too. We know that RefactoringIsProblematic. But we refactor anyway.''
Refactoring is a matter of finding and making explicit an organizational pattern in the ideas of the ThreadMode? exchange. It has the main purpose of making the latent, implicit, possible meanings explicit, reified enough to become a whole - a whole which can in turn be responded to, developed further, on another page, from another perspective.
Refactoring is synthesis. On WardsWiki?, it's described this way:
: Replace a thread mode conversation with a monolog that says the same thing and preserving as much of the original text as possible. Change the 1st person singular to 1st or 3rd person plural. Remove the inline attributions and put them at the end under "Contributors." It is understood that individual authors may not have chosen the exact words used; that we have a consensus and hence probably compromises. [http://c2.com/cgi/wiki?ConvertThreadModeToDocumentMode]
: This is important in refactoring, but it is hard to do correctly. You need to synthesize the discussion in a way that is acceptable to most of the participants. Sometimes a discussion comes to an end, at which time it is easier to summarize it, but there is less motivation to do so. Discussions most need to be summarized when they get long, which usually means there are a lot of different opinions, making them hard to summarize. [http://c2.com/cgi/wiki?ConvertThreadModeToDocumentMode]
: Suppose I refactor a conversation and I (unknowingly, of course) get it wrong. The topic itself will show up in ChangeSummary and RecentChanges. There are good odds that one of the experts on the subject will read it and correct it. [http://c2.com/cgi/wiki?ConvertThreadModeToDocumentMode]
: ''Refactoring is an editor's game. Wanna be an editor? Learn to refactor. There's gonna be a place for expert refactorers in the new economy.''
: ''This section needs development. Not sure where it's going yet.''
: Start with Wiki:RefactoringWikiPages at C2. This page presents techniques and heuristics for refactoring (Wiki:ConvertThreadModeToDocumentMode, Wiki:RefactorByRenaming...) and techniques for designing and presenting the page. We can add to these and adapt them for use on this wiki.


Revision [408]

Edited on 2007-01-08 23:13:23 by MorganAdmin
Additions:
>>see ThreadMode | DocumentMode | StyleGuide
* http://c2.com/cgi/wiki?WikiEssence Wiki Essence: Frames the process of writing and refactoring to create wiki knowledge as the essence of wiki.>>=====RefactoringPages=====
Deletions:
=====RefactoringPages=====>>see ThreadMode | DocumentMode | StyleGuide
* http://c2.com/cgi/wiki?WikiEssence Wiki Essence: Frames the process of writing and refactoring to create wiki knowledge as the essence of wiki.>>


Revision [398]

Edited on 2007-01-08 23:06:04 by MorganAdmin

No Differences

Revision [397]

Edited on 2007-01-08 23:05:39 by MorganAdmin
Additions:
=====RefactoringPages=====>>see ThreadMode | DocumentMode | StyleGuide
* http://c2.com/cgi/wiki?WikiEssence Wiki Essence: Frames the process of writing and refactoring to create wiki knowledge as the essence of wiki.>>
Deletions:
see ThreadMode | DocumentMode | StyleGuide
* http://c2.com/cgi/wiki?WikiEssence Wiki Essence: Frames the process of writing and refactoring to create wiki knowledge as the essence of wiki.


Revision [150]

The oldest known version of this page was created on 2006-12-13 13:43:24 by MorganAdmin
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki