விரைவுத் தொடக்கம்
Dropstone ஐ நிறுவி, உள்நுழைந்து, ஐந்து நிமிடங்களுக்குள் உங்கள் முதல் மாற்றத்தை வெளியிடுங்கள். இந்த வழிகாட்டி உங்களை பூஜ்ஜியத்திலிருந்து வேலை செய்யும் ஏஜென்ட் லூப்பிற்கு அழைத்துச் செல்கிறது.
இந்த வழிகாட்டியின் முடிவில், Dropstone ஐ நிறுவி, உள்நுழைந்து, உங்கள் விருப்பத் திட்டத்தில் உண்மையான திருத்தங்களை உருவாக்கும் நிலையில் இருப்பீர்கள்.
தொடங்குவதற்கு முன்
உங்களுக்கு தேவை:
- ஒரு டெர்மினல் அல்லது கட்டளை வரியூட்டி
- Dropstone ஐ சுட்டிக்காட்ட உங்கள் கணினியில் ஒரு திட்டம் (எந்த மொழியிலும், எந்த அளவிலும்)
- ஒரு Dropstone கணக்கு, அதை dropstone.io இல் உருவாக்கலாம்
படி 1: Dropstone ஐ நிறுவவும்
உங்கள் இயங்குதளத்திற்கான நிறுவல் வழியைத் தேர்ந்தெடுக்கவும்.
Homebrew (பரிந்துரைக்கப்படுகிறது):
brew tap blankline-org/dropstone-cli
brew install dropstone
அல்லது நிறுவல் ஸ்கிரிப்ட்:
curl -fsSL https://dropstone.io/install | bash
இரண்டு முறைகளும் உங்கள் PATH இல் ஒரு dropstone பைனரியை நிறுவுகின்றன. Node இல்லை, ரன்-டைம் சார்புகள் இல்லை.
நிறுவலைச் சரிபார்க்கவும்:
dropstone --version
நீங்கள் ஒரு பதிப்பு எண்ணைக் காண வேண்டும் (தற்போதைய வெளியீடு 1.0.8). பைனரி தொடங்கும்போது புதுப்பிப்புகளைச் சரிபார்த்து நிறுவுகிறது, எனவே நிறுவியை மீண்டும் இயக்காமல் நீங்கள் தற்போதைய நிலையில் இருக்கிறீர்கள். Homebrew உடன் நிறுவியிருந்தால், brew upgrade dropstone ஐப் பயன்படுத்தவும் — Homebrew அந்த பைனரியை வைத்திருக்கிறது, Dropstone அதைத் தொடாது.
படி 2: உள்நுழைக
எந்த திட்ட கோப்பகத்திற்கும் சென்று Dropstone ஐத் தொடங்கவும்:
cd /path/to/your/project
dropstone
முதல் தொடக்கத்தில் உள்நுழையும்படி கேட்கப்படுவீர்கள். இரண்டு விருப்பங்கள்:
- உலாவியில் தொடரவும் (பரிந்துரைக்கப்படுகிறது). dropstone.io/login ஐத் திறந்து, உங்களை உள்நுழையச் செய்து, டோக்கனை தானாகவே CLI க்கு திருப்பி அனுப்புகிறது. PKCE ஐப் பயன்படுத்துவதால், டோக்கன் உங்கள் உலாவி URL பட்டியில் தோன்றாது.
- டோக்கனை ஒட்டவும். SSH அல்லது ஹெட்லெஸ் அமர்வுகளுக்கு. dropstone.io/account இல் டோக்கனைப் பெற்று அதை ஒட்டவும்.
முதல் உள்நுழைவுக்குப் பிறகு உங்கள் சான்றுகள் வட்டில் சேமிக்கப்படும். பின்னர் கணக்குகளை மாற்ற, Dropstone க்குள் இருந்து /login ஐ இயக்கவும்.
படி 3: உங்கள் முதல் அமர்வைத் தொடங்கவும்
நீங்கள் இப்போது Dropstone முகப்புத் திரையைப் பார்க்கிறீர்கள். மூன்று விஷயங்களைக் கவனிக்கவும்:
- உங்கள் தற்போதைய மாடல் அடுக்கு மேல் வலதுபுறத்தில் காட்டப்படும் (இயல்புநிலை: Dropstone Fast)
- கீழே உள்ள உள்ளீட்டு பெட்டி நீங்கள் தட்டச்சு செய்யும் இடம்
- ஸ்லாஷ் கட்டளைகள்
/உடன் தொடங்குகின்றன. அவற்றைப் பார்க்க/helpமுயற்சிக்கவும்
ஒரு அமர்வைத் தொடங்க எந்த இயற்கை மொழி கேள்வியையும் தட்டச்சு செய்யவும். கற்றுக்கொள்ள சிறப்பு தொடரியல் இல்லை.
படி 4: உங்கள் முதல் கேள்வியைக் கேளுங்கள்
Dropstone திட்டத்தை உங்களுக்காக சுற்றிப்பார்க்கட்டும். இவற்றில் ஒன்றை முயற்சிக்கவும்:
இந்த திட்டம் என்ன செய்கிறது?
முக்கிய நுழைவு புள்ளிகள் யாவை?
கோப்புறை அமைப்பை விளக்குங்கள்
Dropstone தேவைக்கேற்ப கோப்புகளைப் படித்து, உண்மையான குறியீட்டிற்கான மேற்கோள்களுடன் பதிலளிக்கும். நீங்கள் கோப்புகளை ஒட்டவோ அல்லது சூழலை கைமுறையாக எழுதவோ தேவையில்லை.
Dropstone பற்றி அதையும் கேட்கலாம்:
இந்த திட்டத்தில் நீங்கள் என்ன செய்ய முடியும்?
எந்த கட்டளைகளை இயக்க உங்களுக்கு அனுமதி வழங்கப்பட்டுள்ளது?
படி 5: உங்கள் முதல் குறியீடு மாற்றத்தைச் செய்யுங்கள்
இப்போது ஒரு சிறிய மாற்றத்தை விவரிக்கவும். புதிய திட்டத்திற்கு, குறைந்த ஆபத்துள்ள ஒன்றை முயற்சிக்கவும்:
ஒரு பத்தி திட்ட விளக்கத்துடன் README சேர்க்கவும்
ஏற்கனவே உள்ள திட்டத்திற்கு:
பயனரை உருவாக்கும் செயல்பாட்டிற்கு உள்ளீட்டு சரிபார்ப்பைச் சேர்க்கவும்
Dropstone:
- தொடர்புடைய கோப்பைக் கண்டறியும்
- முன்மொழியப்பட்ட மாற்றத்தை diff ஆகக் காண்பிக்கும்
- எழுதுவதற்கு முன் உங்கள் ஒப்புதலைக் கேட்கும்
- முடிவைச் சரிபார்க்கும் (வகை சோதனைகள், சோதனைகள், லிண்ட்கள் கிடைத்தால்)
அனுமதிகள்
Dropstone ஒரு கோப்பைத் திருத்த அல்லது ஷெல் கட்டளையை இயக்க முதல் முறை ஒப்புதல் கேட்கிறது. ஒருமுறை ஒப்புதல் அளித்தால், அதே அமர்வில் அதே செயல்பாடு மீண்டும் கேட்காமல் இயங்கும். நீங்கள் அனுமதித்ததைப் பார்க்க அல்லது ரத்து செய்ய /permissions ஐப் பயன்படுத்தவும்.
படி 6: git உடன் வேலை செய்யுங்கள்
Dropstone git ஐ முதல் தர கருவியாகக் கருதுகிறது:
நான் எந்த கோப்புகளை மாற்றியுள்ளேன்?
என் மாற்றங்களை விளக்கமான செய்தியுடன் கமிட் செய்யுங்கள்
feature/health-endpoint என்ற பிராஞ்சை உருவாக்கி அதற்கு மாறவும்
கடைசி ஐந்து கமிட்களைக் காட்டுங்கள்
src/auth.ts இல் உள்ள மெர்ஜ் மோதலை தீர்க்க உதவுங்கள்
PR அளவிலான பணிகளுக்கு (புல் ரிக்வெஸ்ட்களைத் திறப்பது, PR விளக்கங்களை உருவாக்குவது, மதிப்பாய்வு கருத்துகளை இடுவது), GitHub ஒருங்கிணைப்பு ஐப் பார்க்கவும்.
படி 7: பிழையை சரிசெய்யவும் அல்லது அம்சத்தைச் சேர்க்கவும்
நீங்கள் விரும்புவதை எளிய மொழியில் விவரிக்கவும். Dropstone குறியீட்டைக் கண்டறிந்து, சூழலைப் புரிந்துகொண்டு, மாற்றத்தைச் செயல்படுத்தி, சரிபார்க்கும்.
காலி தேடல் கேள்விகள் அனைத்து முடிவுகளையும் திருப்பும் பிழை உள்ளது - அதை சரிசெய்யவும்
API சேவையகத்திற்கு பில்ட் தகவலைத் திருப்பும் /healthz முனையத்தைச் சேர்க்கவும்
மின்னஞ்சல் இல்லாதபோது உள்நுழைவு படிவம் செயலிழக்கிறது - காரணத்தைக் கண்டறிந்து சரிசெய்யவும்
பணி பல கோப்புகளில் பரவினால், Dropstone ஒரு சிறிய திட்டத்தை எழுதி படிப்படியாக செயல்படுத்தும். எந்த நேரத்திலும் Esc ஐ அழுத்தி குறுக்கிட்டு வழிநடத்தலாம்.
படி 8: மற்ற பொதுவான பணிகளை முயற்சிக்கவும்
Dropstone சிறப்பாக செய்யும் சில முறைகள்:
ரீஃபாக்டர்
auth தொகுதியை கால்பேக்குகளுக்கு பதிலாக async/await பயன்படுத்த ரீஃபாக்டர் செய்யுங்கள்
சோதனைகளை எழுதுங்கள்
கால்குலேட்டர் செயல்பாடுகளுக்கு யூனிட் சோதனைகளை எழுதுங்கள்
குறியீடு மதிப்பாய்வு
என் ஸ்டேஜ் செய்யப்பட்ட மாற்றங்களை மதிப்பாய்வு செய்து ஆபத்தானவற்றைக் குறிக்கவும்
ஆவணங்கள்
README நிறுவல் வழிமுறைகளை WSL பாதையைச் சேர்க்க புதுப்பிக்கவும்
Tip
Dropstone உடன் ஒரு சக ஊழியரைப் போல பேசுங்கள். நீங்கள் அடைய விரும்புவதை விவரிக்கவும், அங்கு செல்லும் சரியான படிகளை அல்ல. செயல்படுத்தல் தேர்வுகளை அதற்கு விட்டுவிடும்போது ஏஜென்ட் சிறந்த திட்டமிடுகிறது.
அத்தியாவசிய கட்டளைகள்
நீங்கள் உண்மையில் பயன்படுத்தும் சில கட்டளைகள்:
| கட்டளை | அது என்ன செய்கிறது | எடுத்துக்காட்டு |
|---|---|---|
dropstone | தற்போதைய கோப்பகத்தில் ஊடாடும் அமர்வைத் தொடங்கவும் | dropstone |
dropstone run "task" | ஒரு முறை பணியை இயக்கி வெளியேறவும் | dropstone run "explain auth.ts" |
dropstone -c | இந்த கோப்பகத்தில் கடைசி அமர்வைத் தொடரவும் | dropstone -c |
dropstone --session ID | குறிப்பிட்ட அமர்வை ஐடி மூலம் மீட்டெடுக்கவும் | dropstone --session 7f3a... |
/help | அனைத்து ஸ்லாஷ் கட்டளைகளையும் காட்டவும் | அமர்வுக்குள் |
/effort | இந்த அமர்வுக்கான மாடல் அடுக்கை மாற்றவும் | /effort high |
/clear | தற்போதைய உரையாடலை அழிக்கவும் | அமர்வுக்குள் |
/login | கணக்குகளை மாற்றவும் | அமர்வுக்குள் |
exit அல்லது Ctrl+D | Dropstone ஐ விட்டு வெளியேறவும் |
முழு குறிப்பு CLI மற்றும் ஸ்லாஷ் கட்டளைகள் பக்கங்களில் உள்ளது.
புதிய பயனர்களுக்கான தொழில்முறை குறிப்புகள்
அடுத்தது என்ன
உதவி பெறுதல்
- Dropstone க்குள்,
/helpதட்டச்சு செய்யவும் அல்லது எளிய மொழியில் கேளுங்கள் ("நான் எப்படி மாடல்களை மாற்றுவது?") - மீதமுள்ள ஆவணங்களை docs.dropstone.io இல் பார்க்கவும்
- ஒரு சிக்கல் அல்லது அம்ச கோரிக்கையை dropstone.io/contact இல் பதிவு செய்யவும்