“A log is used to communicate ongoing activity to other collaborators”
Pour nous aider a nous organiser mieux entres-nous en réduisant les distances … et on espère en nous poussant a publier plus nos contributions au lieu de le garder dans nos ordi ou dans Trello …
Ceux qui le souhaite l'utiliser peuvent lister ici leur journal.
Journaux des contributeurs
Journaux des projets (sera remplace avec un outil de suivi projet)
Les conseils de OSE US (a traduire et adapter a notre organisation):
des conseilles de Marcin OSE US: http://opensourceecology.org/wiki/Daily_Log_of_Tasks
OSE promotes the use of a Log by all individuals and projects because the key to effective global collaboration is transparency and awareness of what any other individual or team is doing. A Log is a concise summary of tasks done with numerous hyperlinks to work product. It is intended to be used primarily for planning, review, and coordination. It is different than a regular Blog in that it focuses on access to work product as opposed to a narrative. Logs are intended to be quick notes, which take a few seconds of time and are therefore not a chore. They should not be as refined as Blog or some other piece of formal writing - the goal is to simly keep a record of ongoing activity with intent of maximizing collaboration. The simple theory behind a Log, and behind documentation in general - is that if it not documented, it effectively does not exist - from the standpoint of potential collaboration over the internet. One should keep in mind that a log is a permanent record, and as such, if nobody reads it today or tomorrow, it does not mean that someone won't see it next year - if the content is relevant from a long-term perspective.
To start a work log, set up an account and log in to the Wiki - see Instructions. Then create a page titled Your_Name_Log - such as Marcin Log. Keep daily entries for every day Monday-Friday, and record entries with a date. The format for the dates should be placing the date in between = signs (this is a heading in Wiki language). The proper heading format is, for example, “Tue Apr 8, 2014”. Then, record newer entries on top, so that one does not have to scroll down a page to see your latest work. When recording entries, you should have a link or picture embed to all that you have done.
List of Logs
*See Logs for project-based and person-based logs en OSE US.
Work Log Checklist
'Log so you can learn to do it better the next time.'
#Did you link to your work product?
#When listing items that you have done, did you write down a complete list to avoid potential redundancy with other collaborators working in parallel?
#Did you include a link to your email that you copied on the wiki? Include all emails that are related to global collaboration (emails that will hold value from now until the next 5 years). Ex.“Yesterday I sent an Input Email Here”
#Is your log for that day self contained (ie, do not say something like, “finish goals of last week”, but instead, list them explicitly)?
#Is the entry specific, so others could help?
#Is the entry
#Did you write no more than 3 goals in your weekly planning?
#Did you bold your weekly planning and review?
#Are you keeping your log compact?
#Is continuity/progress from the former's week work clear in the weekly planning and review?
*Update log daily or as relevant work is done. Presumption of non-logging in a given time period is that no work has been done. *Add most recent update on top of page *Link directly to new results every day so that result can be viewed in one click from your log *Log items that have been logged previously, if updates have been made to those links *If you are linking to an update on a page and only a small item has changed on that page, link to that specific item that has been changed - if possible. *Keep log tight and short. Put all results on other pages, and link to those pages - so that a comprehensive picture of one's work is seen immediately. See Marcin Log as an example. *At best, the Work Log should consist mostly of hyperlinks, with short description of what the hyperlink is.
Log of progress should include who was contacted, resources found, links to work product generated, comments on what is working and not working, and any insights on the organizational process. See Marcin Log for an example. Tasks shall be logged as soon as they are completed. This is intended for:
'Organizational learning' - to assess and review the duration of tasks, scope of tasks performed, what worked and what didn’t. Future team members can look at the log, learn from the tasks done, and assess the time that it takes to do certain tasks.
'Team coordination and project status'- Work logs are universally identified within the team as a location for logging activity, and have a unique URL that any other team member can access, as in opensourceecology.org/wiki/Name_Log - with the name corresponding to the team member’s name. Any team member can view another person’s log. Since the log is done on a continuous basis as soon as tasks are comppleted, anyone can find out what has been done as soon as it has been done.
'Transparency'. This allows other team members to see what is happening for purposes of transparency. Credit can thus be given properly to those who log tasks. If a task is not logged, others can not learn more about that task. Such trasnparency promotes autonomous operation within OSE.
'Self-Verifiability'. Self-verifiability is an aspect of Transparency. Self-verifiability of the work log can be achieved by linking directly to work product - so that credit can be given for work done.
'Management scalability' - Work logs provide universal indexing of a person’s work. Once there is a large number of people working on a project, an easy way to access a person’s work product is through the person’s log. The log is intended to be accessible with zero access barriers, an essential part of an open, collaborative organization. A log allows indexing of large amounts of disperse content from an unlimited number of people.
'Open culture' - Work Logs are visible to the world, and thus promote working openly and collaboratively.
To facilitate effective communication via the Daily Log, keep the following points in mind in order to help others learn rapidly from and assess your work.
'First and foremost - log your work in a concise paragraph instead of spreading it over a number of pages, and link to work product on other pages instead of embedding work product on the Work Log.' This allows one to see daily work and weekly work product readily.
*Critical insights should be captured in the log. If a link is simply posted, one cannot tell what to expect from the link.
*The power of the wiki lies in using wikiwords - ie, a word or phrase in double brackets in edit mode allows you to link directly to any other page or subheading on the wiki. This way, you can build on former work without having to explain each time. Any wikiword becomes its own page on the wiki.
*Communicate as much as possible like you are commuinicating to the first-time reader in order to provide perspective. This means for concepts or formerly entered concepts or pages - link to those pages in your explanations as wiki words.
*Feel free to create pages that are simply definitions of words or phrases that you are using - so you can refer to that page any time in the future by putting the link in double brackets.
*Do not overwrite wikiwords that are already used if you are documenting a different usage of that wikiword, just start a page with a different wikiword. This is because any other pages that link to that page would then be pointing to the wrong definition.
*To inform the reader more fully, try to provide context as relevant. For example - if a link is a new entry in the wiki, write 'Started page so and so'.
*Always try to inform the reader about the context and perspective of your work. Useful work could be finding, sourcing prices, finding an online design calculator, reading, reviewing, starting wiki pages, editing a wiki page, continuing on work from another day, making video, taking pictures, writing an instructional, conference calling, getting something reviewed, picking up where someone else left off, etc… Please make a note of such activity and include a link to anything online, and for something that you generated (picture, document, video), upload it and link to it.
*If you want to upload an unsupported file format to the wiki which the wiki does not allow you to upload - compress it to a zip or other format and upload it then. The wiki supports uploads of compressed files such as .zip.
*If you are adding to an existing page, think of creating a subsection so that you can link to it directly as a wiki link. Otherwise, the only way for the reader to see what you have contributed is to look at the page history, which takes more time.
*If you are reporting a physical result, you should include a picture or video.
*If you are reporting a concept design, link to a google doc drawing or other diagram .
*If you are doing conceptual design - use google docs - so others can view and download the source. Set up sharind accordingly.
*If you are embedding google docs, paste a link to the actual document so others can access it directly to view, comment, or edit. This allows global collaboration to happen.
*When posting pictures or files - do not just put them on your log - but also on the related wiki page for that particular project.
*If you are uploading pictures as a zipped file - embed at least some of the pictures or thumbs themselves for viewing - for easy access - especially if the file is large and it takes a long time to download just to view the pictures.
To make the most use of the log as a cloud platform: *Keep track of and coordinate with other core developers. Take any name - and you should be able to find their log: ex: Marcin Log, Gabi Log, Yoonseo Log, Lenny Wayne Log. *There are also project based logs - Guatemala Log, Power Cube Log - in addition to personal logs - for tracking projects which have multiple participants. *Any documentation relevant to GVCS technical deployment - video, pictures, diagrams, reeviews, etc - should be copied to or linked to the wiki. For example, a picture of a build should be embedded in a wiki procedure, and if there is a relevant album of images, that link should be placed on the wiki. *Google Docs should be embedded and an Edit link should be added for easy access. *Iframes and other embeds should be taken advantage of - to make the Wiki a central repository of all project-related material.
*Document any work relevant to critical path as discussed in Executive Director's Statement for deploying the GVCS and building the world's first, post-scarcity, open source, global village.
*Write a Weekly Milestones plan for review on Monday noon daily coordination meeting.
'Use hyperlinks for work product.' Do this by putting hyperwords in double brackets. See Wiki Instructions.
*Make every day indexable by entering it as a heading, such as =Thu Oct 11, 2012=, such that any day can be accessed from an automatically-generated index on top of wiki page.
*Use Weekday, Month, Day, Year as standard headings, such as =Thu Oct 11, 2012=
*Roll up entries into a single link on a monthly basis, see bottom of Marcin Log for example.
For a log to be effective it should provide on a daily basis:
#Tasks done #Comments on important learnings #Links to all work product that took more than 15 minutes to complete. All work should be documented on wiki ##This is easy for organizational work: start a wiki page with what you did with links ##For physical work, take pictures and vlogs, link to them as your work product #Do this on a running basis to allow the log to serve as a monitor of progress that other team members can use to facilitate coordination on a sub-hour timescale
On a weekly basis - the Log should provide a Weekly Assessment- including Planning and Review: #At the beginning of the week, list your goals for the week #At the end of the week, assess: ##Did you meet your milestones? ##If not, why not, and how you can do better?
Make it really simple. Start a wiki page named Name_Log, such as Marcin Log. Add new posts on top of page. Every two weeks, roll up the entries into a 2 week history - so the Index doesn't get too lengthy. Repeat for every month, quarter, and year.
#Log tasks in an ongoing fashion. #Week plan due Monday: what do you intend to do this week (in your own words) #What did you in fact do this past week? What unplanned items? #What is your own assessment of that / your progress?
#Share it with each other - over Monday dinner? #Sharing it means, if you didn't do it, you at least have to think about it while being shared. #You want to write things down, because then it'll be hard to think of things you did, and it'll look to the group like you didn't do anything.
Explanation of Daily Log
The purpose of the Daily Log is to facilitate organizational learning and performance management by promoting feedback, assessment, and transparency. The Daily Log is required for people at Factor e Farm.
A Log allows others to access quick links to review work - which is highly relevant when working on a distributed team where many people provide feedback. This assumes that links must be explicit - we do not assume that someone knows how to find a link online.
When people log their work - this work can be evaluated and assessed for efficiency, direction, and prioritization. Without a task log, it is not possible to evaluate and learn about what a person is doing.
Further, OSE is an organization that incubates other OSE Incubators. For organizational learning across these Incubators and other OSE Chapters, it is important to document what people are doing to clarify expectations/process/etc.
Further, the weekly Log serves as the basis for Monthly Planning and Review: #What were the major milestones reached? #What were the major milestones missed? #What did you learn this month? #What could you have done better? #What are your milestones for next month?
See sample Daily Log - Marcin Blog
From Colby: Have a process where people set their own goals and timeline and present them to the group and file them on a wiki. Then meet weekly and have them add a status update with what they accomplished over the week (or even daily).
Each month, have them present to the group the summary of their accomplishments each week, lessons learned, how they are on schedule, what “unplanned items” came up that delayed the schedule.
Keep track over time, the number of weeks in which they hit their own goals and didn't. Offer each time they don't hit their goals that they can come for you for advice.
The same thing applies to under and over budget, etc.
Once a month or week, take part of a day and sit down with each person for 10-15 minutes to discuss what is going well and isn't… and look at their progress reports and schedule.
*See list of logs de OSE US- Logs