விரைவுத் தொடக்கம்
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). பைனரி பின்னணியில் தானாகவே புதுப்பிக்கப்படும், எனவே நிறுவியை மீண்டும் இயக்காமல் நீங்கள் தற்போதைய நிலையில் இருப்பீர்கள்.
படி 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 ஐ முதல் தர கருவியாகக் கருதுகிறது:
நான் எந்த கோப்புகளை மாற்றியுள்ளேன்?
விளக்கமான செய்தியுடன் எனது மாற்றங்களை commit செய்யவும்
feature/health-endpoint என்ற பிராஞ்சை உருவாக்கி அதற்கு மாறவும்
கடைசி ஐந்து commits காட்டவும்
src/auth.ts இல் உள்ள merge conflict ஐ தீர்க்க உதவுங்கள்
PR நிலை பணிப்பாய்வுகளுக்கு (pull requests திறப்பது, PR விளக்கங்களை உருவாக்குவது, மதிப்பாய்வு கருத்துகளை இடுவது), GitHub ஒருங்கிணைப்பு பார்க்கவும்.
படி 7: பிழையை சரிசெய்யவும் அல்லது அம்சத்தைச் சேர்க்கவும்
நீங்கள் விரும்புவதை எளிய மொழியில் விவரிக்கவும். Dropstone குறியீட்டைக் கண்டறிந்து, சூழலைப் புரிந்துகொண்டு, மாற்றத்தைச் செயல்படுத்தி, அதைச் சரிபார்க்கும்.
காலி தேடல் வினவல்கள் அனைத்து முடிவுகளையும் திருப்பும் ஒரு பிழை உள்ளது - அதை சரிசெய்யவும்
API சேவையகத்திற்கு build தகவலைத் திருப்பும் /healthz முனையத்தைச் சேர்க்கவும்
மின்னஞ்சல் இல்லாதபோது உள்நுழைவு படிவம் செயலிழக்கிறது - ஏன் என்பதைக் கண்டறிந்து சரிசெய்யவும்
பணி பல கோப்புகளில் பரவினால், Dropstone ஒரு சிறிய திட்டத்தை எழுதி படிப்படியாக செயல்படுத்தும். எந்த நேரத்திலும் Esc அழுத்தி குறுக்கிட்டு வழிநடத்தலாம்.
படி 8: மற்ற பொதுவான பணிப்பாய்வுகளை முயற்சிக்கவும்
Dropstone சிறப்பாக செய்யும் சில முறைகள்:
மறுகட்டமைப்பு
auth தொகுதியை callbacks க்கு பதிலாக async/await பயன்படுத்த மறுகட்டமைக்கவும்
சோதனைகளை எழுதுங்கள்
கால்குலேட்டர் செயல்பாடுகளுக்கு யூனிட் சோதனைகளை எழுதுங்கள்
குறியீடு மதாய்வு
எனது staged மாற்றங்களை மதாய்வு செய்து ஆபத்தானவற்றை சுட்டிக்காட்டுங்கள்
ஆவணப்படுத்தல்
README நிறுவல் வழிமுறைகளை WSL பாதையைச் சேர்க்க புதுப்பிக்கவும்
உதவிக்குறிப்பு:
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 இல் பதிவு செய்யவும்