Git Winch Guide

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
hashtagvalues [2025/06/15 19:33] – adminhashtagvalues [2025/09/21 16:01] (current) – admin
Line 1: Line 1:
 ======Hashtag Value Analysis====== ======Hashtag Value Analysis======
  
 +**Introduction**\\
 +This is a special feature of //Git Winch// that can be used in multiple-ways in any office. The core reason for using this feature is to do assessment of work. An owner or manager would often be keen to know and award marks for the work being done in the office. Usually, this is done in the Kanban groups. But you can also use the same approach for assessing the creation of various files in the office too.
 +
 +The central concept that we work with and further expand is called "//hashtags//". Let us explain:
 +
 +**Hashtags**\\
 You must have heard of //hashtags.// That is a rather clever way of organizing loosly-structured information. You would see hashtags used on social media sites such as Twitter, written like this: //#gitwinch.//  When you see that word which starts with the "hash" sign ('#') Twitter allows you to search by that term by clicking on it. It will display all the posts on Twitter that uses the same hashtags. You must have heard of //hashtags.// That is a rather clever way of organizing loosly-structured information. You would see hashtags used on social media sites such as Twitter, written like this: //#gitwinch.//  When you see that word which starts with the "hash" sign ('#') Twitter allows you to search by that term by clicking on it. It will display all the posts on Twitter that uses the same hashtags.
  
Line 9: Line 15:
 To avoid that, what many do is to tag the same content with //multiple// hashtags. That results in a lot of "hashtag-clutter" which again brings in its own confusion. To avoid that, what many do is to tag the same content with //multiple// hashtags. That results in a lot of "hashtag-clutter" which again brings in its own confusion.
  
-**Hashtags**\\ +**Uniform, Common Hashtags**\\ 
-What we propose is to keep one common reference file for the hashtags that you want to use in the office. One useful method is to invent and get the office to agree upon the hashtags for the various kinds of work that is being done in the office. +What we propose is to keep one common reference file for the hashtags that you want to use in the office. To avoid confusion, your office can agree on a common set of hashtags for different types of work.. 
  
 For example: In an architect's office, people are doing #admin work, #clientmeetings, #accounts, #gfcdocs, #redlining, #designing, #rendering ... so that office agrees upon the hashtags that should be used. Ideally, use only one word (i.e. without spaces) to define such hashtags. For example: In an architect's office, people are doing #admin work, #clientmeetings, #accounts, #gfcdocs, #redlining, #designing, #rendering ... so that office agrees upon the hashtags that should be used. Ideally, use only one word (i.e. without spaces) to define such hashtags.
Line 38: Line 44:
  
 **Flexible and //loosely-coupled//**\\ **Flexible and //loosely-coupled//**\\
-This is extremely useful in small/medium size offices where people may be asked to do //different kinds// of work. One source of anguish that employees often have is that they don't get recognized (aka paid) for the hard-work they put in different types of work they did for the office.  Such hashtag values can be inserted in appraisals between an employee and his/her manger or owner as comments into the Kanban system. +The concept of //hashtag values// is extremely useful in small/medium size offices where people may be asked to do //different kinds// of work. One source of anguish that employees often have is that they don't get recognized (aka paid) for the hard-work they put in different types of work they did for the office.  Such hashtag values can be inserted in appraisals between an employee and his/her manger or owner as comments into the Kanban system. 
  
 This is a //loosely-coupled// system. Which means, we do not insist that you //must// use this. Maybe you may use this with other variations. For e.g. instead of giving the values as number of hours spent, it could be percentages, reward points or actual money or some kind of //gamification// points... that's all up to that office which uses //Git Winch//.  This is a //loosely-coupled// system. Which means, we do not insist that you //must// use this. Maybe you may use this with other variations. For e.g. instead of giving the values as number of hours spent, it could be percentages, reward points or actual money or some kind of //gamification// points... that's all up to that office which uses //Git Winch//. 
Line 44: Line 50:
 But if you do use this method (in whatever variations) our system can collect these hashtag-values and put give them  as a CSV file to you. Then you can choose how to use that CSV file as per your office policies. But if you do use this method (in whatever variations) our system can collect these hashtag-values and put give them  as a CSV file to you. Then you can choose how to use that CSV file as per your office policies.
  
-**How to do Hashtag Value analysis**\\ +=====How to do Hashtag Value analysis===== 
-When you click on the 'Hashtag Analysis' button in the //Manage// page, //Git Winch// fill first ask you to load a text file which contains the hashtags you want to retrieve. For example; if you want to find out Hashtag values for the following hashtags: #admin, #accounts, #redlining enter this line into a text file and save that. +When you click on the 'Hashtag Analysis' button in the //Manage// page, //Git Winch// fill first ask you to load a text file which contains the hashtags you want to retrieve. That is called the //reference// file.  
 + 
 +For example; if you want to find out Hashtag values for the following hashtags: #admin, #accounts, #redlining enter this line into a text file and save that. 
  
    accounts,admin,redlining    accounts,admin,redlining
  
-If you notice, there are no # character there, and each hashtag is separated from the next by a comma. Do not use carriage returns. It is a simple text file, which can be created/edited using Notepad,Notepad++ and other such //text-editors//. Do NOT use word-processors such as Microsoft Word, etc. +If you notice, there are no //#// character in there, and each hashtag is separated from the next by a comma.  
 + 
 +Do not use carriage returns. It is a simple text file, which can be created/edited using Notepad,Notepad++ and other such //text-editors//. Do NOT use word-processors such as Microsoft Word, etc.  
 + 
 +So this is the reference file that you need to load when clicked the "Hashtag Analysis" button in the //Manage// page. 
 + 
 +**NOTE:**\\  
 +The above file only lists the //possible// hashtags that would be checked. However, the final CSV file would ONLY be generated from the //actual// hashtags that the you as the owner used.  
 + 
 +For e.g. Though in the above file, the office had listed //accounts//, //admin// and //redlining// as the possible tags; but it turns out that you (owner) used only //admin// and //redlining// and //breakout// then actually only //admin// and //redlining// would be seen in the CSV file.  
 + 
 +The //breakout// tag sadly was not listed in the reference file and so was ignored. Also //accounts// hashtag was not used and so that also would not be seen in the CSV.
  
-So this is the file that you need to load when clicked the "Hashtag Analysis" button in the //Manage// page. 
  
 Then //Git Winch// will extract those hashtag-values and place them into a CSV file. You can then further work on that CSV file using a spreadsheet application such as Excel, and complete the analysis. Then //Git Winch// will extract those hashtag-values and place them into a CSV file. You can then further work on that CSV file using a spreadsheet application such as Excel, and complete the analysis.
  
 +=====Who can do this analysis?=====
  
-**Who can do this analysis**\\ +Anyone can invoke the Hashtag analysis. However; internally, //Git Winch// will assume that you are the owner of some //Kanban Group// in the web-app, and also owner of some repositories too. If you are not an owner of either, the generated CSV file will be empty. 
-Anyone can invoke the Hashtag analysis. Internally, //Git Winch// will assume that you are the owner of some //Kanban Group// in the web-app, and also owner of some repositories too. If you are not an owner of either, the generated CSV file will be empty.+
  
-Internally, //Git Winch// will check the backend coordination server's database and note down which all Kanban cards where you have commented, and all repository file-notes with your notes too. (Note: As stated above, only for the Kanban groups and Repositories that you had created). +**//Git Winch// will only search in Kanban groups and repositories where you are the owner.**
  
-It will find out who else was the one who created the Kanban card. Or, in case of Repository file-notes; who else had written notes for that particular file. The first line of such comments and/or notes would be examined for comma-separated //hashtag values//.+Internally, //Git Winch// will check the backend coordination server's database and note down which all Kanban cards where you have commented, and all repository file-notes with your notes too. (Note: As stated above, I am repeating: only for the Kanban groups and Repositories that you had created). The first line of such comments and/or notes would be examined for comma-separated //hashtag values//.
  
-For example; on one comment for a particular Kanban card you wrote the following comment+It will find out the person who created the Kanban card. Or, in case of Repository file-notes; it will note down all members who had written notes for that particular file.  
 + 
 +For example; on one comment for a particular Kanban card you may have written the following comment
  
    #admin:4.5    #admin:4.5
  
-In another file-note you had written the following +In another file-note you had written the following: 
  
    #redlining:8;admin:9.5    #redlining:8;admin:9.5
  
-As you can see; you did not write just #admin or just #redlining. Instead you also gave a value for those hashtags. Again, I am reminding you: //For this action, Git Winch assumes you are the one doing the assessment and it would only check those Kanban groups and repositories, which you had created!//+As you can see; you did not write just #admin or just #redlining. Instead you also gave a value for those hashtags. 
  
-Internally, //Git Winch// will place the values of 4.5 and 9.5 for //#admin//. And 8 would be the value for //#redlining//. Of course, the person to whom this value would be given would be based on whose Kanban card was being worked on. In case, of //file notes//, the values would be attributed to who else had put their own comments on that file.+This is quite similar to a teacher in a classroom giving marks for various subjects to students in the class. So the students (aka other members) themselves do not write their own hashtag values. But it is the teacher (i.e. the creator of the Kanban group or Repository) who wrote the hashtag value as a comment or file-note.
  
-After processing those hashtag values, the CSV file is generated.+Internally, //Git Winch// will place the values of 4.5 and 9.5 for //#admin//. And 8 would be the value for //#redlining//. Of course, the person to whom this value would be given would be based on whose Kanban card was being worked on. In case, of //file notes//, the values would be attributed to all those who had put their own notes onthat file.
  
 +=====Whose hashtag values are to be used?=====
 +ONLY the hashtag values of //owner's// notes on files are used. If other users used hashtag values in their own notes, those will NOT be used. However, in the final CSV file you can read the comments/file-notes that users had made in the last column of the CSV.    
 +
 +After processing those hashtag values, the CSV file is generated. You will get a message stating that the CSV File data is now available, and it will then open a file save dialog.
 +
 +=====Format=====
 Here is the [[csvfile?do=export_xhtml|Hashtag CSV File Format]], which will give you more details on how to read the generated CSV. Here is the [[csvfile?do=export_xhtml|Hashtag CSV File Format]], which will give you more details on how to read the generated CSV.
  
 +=====Additional Info=====
 +
 +**Graphs**\\
 +You can easily visualize the CSV data graphically using this free tool: https://www.csvplot.com/ Just upload the CSV file there. You do not even need a registration. The data is private as it works purely in your browser itself.
  
 **Hierarchical System**\\ **Hierarchical System**\\
hashtagvalues.1750008810.txt.gz · Last modified: by admin

Page Tools