W swoich exploitach do skryptów często sprawdzam, czy skrypt został napisany wcześniej, zanim zacznę od zera. Często mogę znaleźć przynajmniej to, czego potrzebuję, przez Google lub w inny sposób. Następnie dostosowuję to, co znajduję do moich potrzeb i wprowadzam do produkcji. Najlepszą praktyką jest komentowanie mojego kodu i dołączanie informacji o autorze (nie jestem fanem plagiatu). Pojawia się jednak pytanie, w jaki sposób i kiedy należy dodać/zmienić to oznaczenie autora. Użyję przykładowy skrypt z Ed Wilson poza swoim blogu dla odniesienia:Jaki jest właściwy sposób udostępniania środków na tworzenie i edytowanie skryptów?
Function Get-OutlookCalendar {
<#
.Synopsis
This function returns appointment items from default Outlook profile
.Description
This function returns appointment items from default Outlook profile. It
uses the Outlook interop assembly to use the olFolderCalendar enumeration.
It creates a custom object consisting of Subject, Start, Duration, Location
for each appointment item.
.Example
Get-OutlookCalendar |
where-object { $_.start -gt [datetime]"5/10/2011" -AND $_.start -lt `
[datetime]"5/17/2011" } | sort-object Duration
Displays subject, start, duration and location for all appointments that
occur between 5/10/11 and 5/17/11 and sorts by duration of the appointment.
The sort is shortest appointment on top.
.Notes
NAME: Get-OutlookCalendar
AUTHOR: ed wilson, msft
LASTEDIT: 05/10/2011 08:36:42
KEYWORDS: Microsoft Outlook, Office
HSG: HSG-05-24-2011
.Link
Http://www.ScriptingGuys.com/blog
#Requires -Version 2.0
#>
Add-Type -AssemblyName "Microsoft.Office.Interop.Outlook" | Out-Null
$olFolders = "Microsoft.Office.Interop.Outlook.OlDefaultFolders" -as [type]
$outlook = New-Object -ComObject Outlook.Application
$namespace = $outlook.GetNameSpace("MAPI")
$folder = $namespace.getDefaultFolder($olFolders::olFolderCalendar)
$folder.items |
Select-Object -Property Subject,Start,Duration,Location
}
wyświetlić polu Autor jako punkt kontaktowy dla tego scenariusza, jak jest to osoba, która napisała go i rozumie je. Czy istnieje ogólna reguła, jak zmienia się scenariusz, zanim nie ma już sensu wymieniać oryginalnego autora? Czy oni zawsze są autorami, a następnie jesteś redaktorem?
W przypadku tego ostatniego, jaki jest odpowiedni sposób na wskazanie tego? Czy dodajesz wiersz pod Autorem oznaczonym "Redaktorem" i zmieniasz ostatnią etykietę edycji? Jak dokładnie jest właściwy sposób dokumentowania swoich wkładów? Czy istnieje udokumentowana najlepsza praktyka?
Prawie przez cały czas, gdy łapię kod z .net, umieszczę blurb na górze z linkiem do oryginału wraz z oryginalnym nazwiskiem autora. Potem opiszę to, co zmieniłem, jeśli tylko z dokładnie tych samych powodów. – NotMe